[ 新加坡 ) BJERRE (Sau Sheong Chang) 落 
黄 健 宏 译 


国 | 中 国 工 信 忠 版 集团 Z 人 民 邮 电 出 版 社 


ZY POSTS & TELECOM PRESS 


封面 播 
第 一 部 分 Go 与 Web 应 用 


第 1 章 GoFWeb)y 

1.1 Goit = #4) 4 Webhy 
1.1.1 Go H WebJ. 
1.1.2 Go 与 模块 化 Web 心 
1.1.3 Go 与 可 维护 的 Web 心 
1.1.4 Go 与 高 性 能 web 心 用 
1.2 Web)» JT. F 

1.3 HTTP 人 简介 

1.4 Web 应 用 的 诞生 

1.5 HTTP 请 求 

1.5.1 请 求 方法 

1.5.2 ZEW KATE 
1.5.3 项 等 的 请 求 方法 


651 651 Sql 


0. 2 2 -Gom 


版 权 信息 


书 名 : Go Web 编 程 
ISBN: 978-7-115-32247-0 
本 书 由 人 民 邮 电 出 版 社 发 行 数字 版 。 版 权 所 有 ， 侵 权 必 究 。 


您 购买 的 人 民 邮 电 出 版 社 电子 书 仅 供 您 个 人 使 用 ， 未 经 授权 ， 不 得 以 
任何 方式 复制 和 传播 本 书 内 容 。 


我 们 愿意 相信 读者 具有 这 样 的 民 知 和 觉悟 ， 与 我 们 共同 保护 知识 产 
AX ° 


如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 对 该 用 户 实 施 包括 但 不 限于 关闭 该 
帐号 等 维权 措施 ， 并 可 能 追究 法 律 责 任 。 


。 车 [新 加 坡 ] 郑 兆 雄 (Sau Sheong Chang) 
译 黄 健 宏 
责任 编辑 杨 海 玲 
。 人 民 邮 电 出 版 社 出 版 发 行 ”北京 市 丰台 区 成 寿 寺 路 11 号 


邮编 100164 ”电子 邮件 315@ptpress.com.cn 


网 址 http://www.ptpress.com.cn 
。 读者 服务 热线 : (010)81055410 


反 盗 版 热线 : (010)81055315 


Original English language edition, entitled Go Web Programming by 
Sau Sheong Chang published by Manning Publications Co., 209 Bruce Park 
Avenue, Greenwich, CT 06830. Copyright © 2016 by Manning 
Publications Co. Simplified Chinese-language edition copyright © 2017 by 


Posts & Telecom Press. All rights reserved. 


本 书 中 文 简体 字 版 由 Manning Publications Co. 授 权 人 民 邮 电 出 版 社 
独家 出 版 未 经 出 版 者 书面 许可 ， 不 得 以 任何 方式 复制 或 抄袭 本 书 内 


容 。 


版 权 所 有 ， 侵 权 必 究 。 


内 容 提要 


本 书 全 面 介绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概念 ， 并 
详细 讲解 如 何 运 用 现代 设计 原则 使 用 Go 语言 构建 Web 应 用 。 本 书 通 过 
大 量 的 实例 介绍 核心 概念 (如 处 理 请 求 和 发 送 啊 应、 模板 引擎 和 数据 
持久 化 ) ， 并 深入 讨论 更 多 高 级 主题 《如 并 发 、Web 应 用 程序 测试 以 
及 部 署 到 标准 系统 服务 器 和 PaaS 提 供 商 ) 。 


本 书 以 一 个 网 络 论坛 为 例 ， 讲 解 如 何 使 用 请 求 处 理 硕 、 多 路 复 用 
磊 、 模 板 引擎 、 存 储 系 统 等 核心 组 件 构 建 一 个 Go Web 应 用 ， 然 后 在 这 
一 应 用 的 基础 上 ， 构 建 出 相应 的 Web 服务 。 值 得 一 提 的 是 ， 本 书 在 介 
绍 Go Web 开 发 方法 时 ， 基 本 上 只 用 到 Go 语言 自 带 的 标准 库 ， 而 不 会 用 
到 任何 特定 的 Web 框 架 ， 读 者 学 到 的 知识 将 不 会 局 限于 特定 的 框 染 ， 
即使 将 来 需要 用 到 现成 的 框架 或 者 目 行 构建 框架 ， 仍 然 会 从 本 书 中 获 
益 。 本 书 除了 讲解 具体 的 Web 开 发 方法 ， 还 介绍 如 何 对 Go Web 应 用 进 
行 测试 ， 如 何 使 用 Go 的 并 发 特性 提高 Web 应 用 的 性 能 ， 以 及 如 何在 
Heroku ` Google App Engine ` Digital Ocean 等 云 平 台 上 部 署 Go WebM 
FA; 此 外 ， 书 中 还 传授 一 些 Go Web 开 发 方面 的 经 验 和 提示 。 这 些 重要 
的 实践 知识 将 帮助 读者 快速 成 为 真正 具有 生产 力 的 Go Web 开 发 者 。 


阅读 本 书 需要 读者 具备 基本 的 Go 语言 编程 技能 并 掌握 Go 语言 的 语 
法 。 本 书 适 合 所 有 想 用 Go 语言 进行 Web 开 发 的 读者 阅读 ， 无 论 征 Web 
开发 的 初学 者 还 是 入 行 已 久 的 开发 者 都 会 在 阅读 本 书 的 过 程 中 有 所 收 
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译 者 记事 


随 独 近年 来 Web 开 发 的 盛行 ， 很 多 相关 书籍 也 随 之 如 雨 后 春 禾 般 
出 现 ， 然 而 在 这 些 书籍 当中 ， 绝 大 多 数 书籍 都 只 关注 表面 的 实现 代 
码 ， 而 对 代码 背后 的 技术 原理 却 少 有 提 及 。 读 者 在 看 这 类 书籍 时 ， 嘲 
然 可 以 学 到 某 个 框架 或 者 某 个 库 的 API， 并 根据 书 中 给 出 的 代码 搭建 
出 一 个 个 演示 程序 (demo) ， 但 是 对 隐藏 在 这 些 代码 之 下 的 原理 却 一 
无 所 知 。 这 种 停留 在 表面 的 理解 一 旦 离开 了 书本 的 指导 ， 就 会 让 人 感 
到 寸步 难 行 ， 不 知 所 措 。 


本 书 的 独特 之 处 在 于 ， 它 抛 开 了 现 有 的 所 有 Go Web 框 架 ， 仅 仅 通 
过 Go 语言 内 置 的 标准 库 来 展示 如 何 去 构 建 一 个 Web 应 用 或 Web 服 务 。 
这 样 做 的 好 处 是 ， 无 论 将 来 读者 十 使 用 这 些 标准 库 来 构建 Web 应 用 ， 
还 是 使 用 现成 的 框架 去 构建 Web 应 用 ， 叉 或 者 使 用 目 己 建造 的 框架 去 
构建 Web 应 用 ， 本 书 介绍 的 知识 都 是 非常 有 用 的 : 如 采 使 用 的 是 现成 
的 框架 ， 那 么 这 些 框 染 的 内 部 实现 通常 束 是 由 本 书 介 绍 的 Go 标准 库 构 
建 的 ， 如 果 选 择 目 建 框架 ， 那 么 将 有 很 大 概率 会 用 到 本 书 介绍 的 Go 标 
准 库 。 因 此 ， 不 论 在 何 种 情况 下 ， 本 书 对 于 构建 Go Web 应 用 都 是 非常 
有 帮助 的 。 


本 书 的 另 一 个 优点 是 ， 它 在 介绍 Web 应 用 开发 技术 的 同时 ， 也 介 
绍 了 隐藏 在 这 些 技术 背后 的 基础 知识 。 比 如 ， 在 介绍 Web 处 理 右 
(handler) 的 创建 方法 之 前 ， 本 书 就 完 深 入 浅 出 地 介绍 了 HTTP 协 议 ， 
然后 才 说 明 具 体 的 请 求 处 理 方法 以 及 啊 应 返回 方法 ;又 比如 说 ， 在 介 


绍 会 话 (session) 技术 时 ， 本 书 就 完 说 明了 HTTP 协 议 的 无 状态 性 质 ， 
然后 才 说 明 如 何 使 用 会 话 去 解决 这 一 问题 ， 类 似 的 例子 在 书 里 面 还 有 
很 多 ， 不 一 而 足 。 对 刚 开 始 接触 Web 开 发 的 读者 来 说 ， 本 书 这 种 “ 知 其 
然 ， 也 知 其 所 以 然 ” 的 教授 方式 能 够 让 读者 打 好 Web 开 发 的 基础 ， 从 而 
达到 事半功倍 的 效果 ; 此 外 ， 对 那些 已 经 有 一 定 Web 开 发 经 验 的 读者 
来 说 ， 本 书 将 在 介绍 Go Web 开 发 方法 的 同时 ， 帮 助 读者 回顾 和 巩固 

Web 开 发 的 相关 基础 知识 ， 并 和 厌 此 成 为 更 好 的 Web 开 发 者 。 


综 上 所 述 ， 我 认为 这 本 书 对 所 有 关心 Web 开 发 的 人 来 说 ， 都 是 非 
营 值 得 一 读 的 一 一 无 论 读者 使 用 的 是 Go 语言 还 是 其 他 语言 、X 框 架 还 
征 Y 框 腰 ， 无 论 读 者 是 web 开发 的 初学 者 还 是 入 行 已 久 的 开发 者 ， 应 该 
都 会 在 阅读 本 书 的 过 程 中 有 所 收获 。 


关于 本 书 的 翻译 


这 本 《Go Web 编 程 》 是 我 的 第 二 部 译作 ， 在 翻译 第 一 部 译作 
《Redis 实 战 》 的 时 候 ， 因 为 受 经 验 、 知 识 以 及 时 间 等 条 件 限制 ， 我 只 
能 把 时 间 尽 量 花 在 保证 译文 的 准确 性 上 ， 但 是 对 于 译文 本 喘 的 可 读 性 
却 未 能 有 太 多 的 关注 。 这 次 在 翻译 这 本 《Go Web 编 程 》 的 过 程 中 ， 我 
给 目 己 订 立 了 更 高 的 目标 ， 那 丈 是 ， 在 你 证 译文 正确 性 的 前 担 下 ， 通 
过 合理 的 用 词 遗 各， 让 译文 更 符合 中 文 表达 方式 ， 并 且 更 具 表 现 力 。 


以 本 书 的 前 言 原文 为 例 ， 其 中 就 有 一 句 “My own journey in 
developing applications for the web started around the same time, in the 
mid-1990s”， 这 人 句 话 的 原意 是 说 作者 的 Web 开 发 生涯 跟 万 维 网 的 发 展 轨 
迹 正好 重合 ， 因 此 把 它 单纯 地 译 为 “本 人 的 Web 应 用 开发 生涯 也 是 从 20 


世纪 90 年 代 中 期 开始 ..…...” 是 完全 没有 问题 的 ， 但 是 通过 在 句子 前 面 添 
加 “无 独 有 侦 ” 一 词 来 与 “around the same time” 的 翻译 “也 是 ”相互 呼应 ， 

束 会 一 下 子 给 译文 带 来 画龙点睛 的 效果 : “无 独 有 个 ， 本 人 的 Web 应 用 
开发 生涯 也 是 从 20 世 纪 90 年 代 中 期 开始 ..…....” 


继续 以 前 言 为 例 ， 在 这 篇 文章 的 原文 当中 ， 出 现 了 不 少 常 见 的 英 
文 短语 和 词汇 ， 这 些 短语 和 词汇 通常 都 有 一 个 正确 、 常 见 并 昌平 庸 的 
翻译 ， 但 是 本 书 却 抛 弃 了 这 些 翻 译 ， 转 而 选择 了 更 准确 也 更 有 表现 力 
的 译 法 。 比 如 说 , “Writing web applications has changed dramatically 
over the years” 中 的 “changed dramatically” 没 有 直译 为 “发 生 了 戏剧 性 的 
变化 ”"， 而 是 翻译 为 “发 生 了 翻天 禾 地 的 变化 ”; “Almost as soon as the 
first web applications were written, web application frameworks 
appeared” 中 的 “were written” 和 “appeared” 没 有 直译 为 “被 编写 出 来 之 
后 ”以 及 “出 现 "， 而 是 分 别 翻译 为 “内 亮 登 场 * 和 “应 运 而 生 ”"， 前 者 突出 
了 了 Web 应 用 的 出 现 对 于 互联 网 的 巨大 改变 ， 而 后 者 则 突出 了 Web 应 用 
和 和 Web 框架 之 间 相 辅 相 成 的 天 系 。 类 似 的 例子 还 有 很 多 很 多 ， 并 且 它 
们 不 仅 出 现在 了 前 言 里 ， 还 出 现在 了 本 书 的 正文 当中 。 


当然 ， 提 高 译文 的 可 读 性 并 不 是 一 件 一 践 而 就 的 事 。 为 了 让 译文 
更 有 “中 文 味 ”， 本 书 的 大 多 数 译文 都 已 三 易 其 稿 ， 有 时 候 仅 仅 为 了 挑 
选 出 一 个 更 恰当 的 词语 或 成 语 ， 就 不 得 不 对 着 词典 推 融 半天 。 这 本 书 
的 翻译 从 2016 年 8 月 开始 ， 到 2017 年 8 月 交 稿 ， 整 整 跨越 了 一 年 时 间 
其 中 翻译 原文 和 润色 译文 两 项 工作 人 花费 的 时 间 可 谓 各 占 一 半 。 如 果 读 
者 能 够 从 译文 的 字里行间 感受 到 这 种 润 物 细 无 声 的 优化 ， 那 将 是 对 本 
人 翻译 工作 最 好 的 肯定 。 


另外 ， 因 为 这 是 一 本 使 用 Go 语言 标准 库 进 行 Web 开 发 的 书 ， 所 以 
对 Go Web 开 发 相关 标准 库 的 理解 程度 将 是 能 否 准确 地 翻译 本 书 技术 内 
容 的 关键 。 为 了 进一步 熟悉 本 书 用 到 的 标准 库 ， 本 人 通读 了 书 中 用 到 
的 各 个 标准 库 的 文档 ， 阅 读 了 其 中 部 分 标准 库 的 源码 ， 并 且 因 为 有 时 
候 “ 好 记性 比 不 上 烂 笔 小 "， 所 以 本 人 还 翻译 了 其 中 一 部 分 标准 库 文 
档 ， 力 求 在 尽 可 能 掌握 标准 库 细节 的 情况 下 ， 再 进行 翻译 ， 尽 量 做 到 
知 其 然 也 知 其 所 以 然 ， 而 不 是 单纯 地 根据 纸 面 上 的 文字 和 代码 进行 翻 


译 。 


最 后 ， 在 翻译 本 书 的 过 程 中 ， 本 人 也 发 现 了 原著 中 大 大 小 小 数 十 
个 bug， 并 在 译文 中 一 一 进行 了 修正 。 综 上 所 述 ， 读 者 看 到 的 这 个 译本 
从 某 个 角度 来 说 将 比 原著 更 准确 也 更 易 读 。 这 也 古 我 一 直 以 来 在 实践 
翻译 工作 时 的 信念 一 一 译作 不 应 该 是 原著 的 “劣化 版 "， 而 古 应 该 以 “ 青 
出 于 蓝 而 胜 于 蓝 ” 的 方式 超越 原著 。 当 然 ， 要 做 到 这 一 点 并 不 是 一 件 容 
易 的 事 ， 但 每 一 个 合格 的 译 者 都 应 该 以 此 为 目标 ,不 断 否 斗 。 


读者 服务 网 站 


为 了 更 好 地 服务 本 书 读者 ， 本 人 专门 为 本 书 搭建 了 读者 服务 网 站 
http:/gwpcn.com。 读 者 只 要 访问 这 个 网 站 ， 束 可 以 查看 到 与 本 书 有 关 
的 各 项 信息 ， 如 本 书 的 简介 、 目 孙 、 试 读 内 容 、 作 译 者 介绍 、 勤 误 信 
思 、 购 买 地 址 以 及 源 代码 下 载 地 址 等 。 


除 此 之 外 ， 正 如 之 前 所 说 ， 本 人 在 翻译 本 书 的 过 程 中 也 翻译 了 一 
部 分 Go 标准 库 的 文档 ， 这 些 文档 可 以 通过 地 址 http://cngolib.com 查 
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最 后 也 是 最 重要 的 ， 我 要 感谢 本 书 翻译 过 程 中 一 如 既往 地 全 力 支 
持 我 的 家 人 和 朋友 ， 多 亏 了 他 们 的 帮助 ， 本 书 的 翻译 工作 才 得 以 顺利 
完成 。 


贡 健 


st 


201744 Fk 


译 者 简介 


BEA (huangz) ， 一 位 1990 年 出 生 的 计算 机 技术 图 书 作 译 者 ， 
《Redis 设 计 与 实现 》 一 书 的 作者 ，《Redis 实 战 》 一 书 的 译 者 。 


除了 已 出 版 的 两 本 作品 之 外 ， 他 还 创作 和 翻译 了 《Go 标准 库 中 文 
MIS) 《Redis 命 令 参考 》《SICP 解 题 集 》 等 一 系列 开源 文档 。 


要 了 解 关 于 黄 健 安 的 更 多 信息 ， 请 访问 他 的 个 人 主页 


http://huangz.me ° 
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目 互 联网 从 20 世 纪 90 年 代 中 期 诞生 以 来 ，Web 应 用 就 以 这 样 或 那 
样 的 方式 存在 了 。 虽 然 Web 应 用 在 最 初 只 能 传输 静态 网 页 ， 但 它 很 快 
就 升级 和 演变 成 了 一 个 令 人 眼花 综 乱 、 能 够 传输 各 种 数据 以 及 实现 各 
种 功能 的 动态 系统 。 无 独 有 偶 ， 本 人 也 是 从 20 世 纪 90 年 代 中 期 开始 接 
触 Web 应 用 开发 的 ， 在 迄今 为 止 的 职业 生涯 当中 ， 我 把 大 部 分 时 间 都 
花费 在 了 大 规模 Web 应 用 的 设计 、 开 发 以 及 团队 管理 上 面 ， 并 且 在 这 
期 间 还 使 用 过 多 种 不 同 的 编程 语言 和 框架 ， 其 中 包括 Java、Ruby ` 
Node.js、PHP、Perl、Elixir 甚 至 是 Smalltalk ° 


几 年 前 ， 我 因为 一 次 偶然 的 机 会 接触 到 了 Go 语言 ， 并 迅速 被 它 的 
简单 和 清爽 直率 所 吸引 ， 而 当 我 意识 到 只 使 用 Go 的 标准 库 就 可 以 快速 
地 构建 完整 、 高 效 并 且 可 扩展 的 Web 应 用 和 服务 时 ， 我 对 Go 的 喜爱 又 
更 进 了 一 步 。 使 用 Go 语言 编写 的 代码 不 仅 易 懂 、 直 截 了 当 ， 而 且 还 能 
够 快速 、 人 简单 地 编译 成 一 个 独立 的 可 部 署 二 进 制 文件 。 更 关键 的 是 ， 
我 不 必 投 入 大 量 服务 絮 束 可 以 让 目 己 的 Web 应 用 变 得 可 扩展 旦 具备 生 
产能 力 。 很 目 然 地 ， 所 有 的 这 些 优点 都 使 Go 成 为 了 我 在 Web 应 用 开发 
方面 最 新 的 心头 好 语言 。 


从 当初 传输 静态 内 容 到 现在 通过 HTTP 传 输 动态 数据 ， 从 当初 使 用 
服务 器 传输 HTML 内 容 ， 到 现在 使 用 客户 端 单 页 应 用 去 处 理 通 过 HTTP 
传输 的 JSON 数 据 ，Web 应 用 的 开发 方式 已 经 发 生 了 翻天 宪 地 的 变化 。 
几乎 就 在 Web 应 用 内 亮 登场 的 同时 ，Web 框 以 也 应 运 而 生 ， 并 使 程序 


员 可 以 更 为 容易 地 去 开发 Web 应 用 。 这 二 十 多 年 以 来 ， 绝 大 多 数 编 程 
语言 都 会 有 至 少 一 个 Web 应 用 框架 ， 其 中 很 多 语言 甚至 会 有 一 大 堆 框 
架 可 用 ， 而 当今 出 现 的 绝 大 多 数 应 用 都 是 Web 应 用 。 


尽管 Web 应 用 框架 的 风靡 使 开发 Web 应 用 变 得 更 加 容易 了 ， 但 这 
些 框 染 在 市 来 方便 的 同时 也 隐藏 了 大 量 的 细 证 一 一 Web 应 用 开发 者 对 
于 万 维 网 的 运作 方式 知之 甚 少 甚至 一 穿 不 通 ， 这 样 的 情况 正在 变 得 越 
来 越 常见 。 笠 运 的 是 ， 通 过 Go 语言 ， 我 发 现 了 一 种 正确 地 教授 Web 应 
用 开发 基础 知识 的 绝 佳 工 具 ， 它 能 够 让 Web 应 用 开发 重新 回 到 集 单 直 
接 的 状态 : 程序 需要 堵 虑 的 就 古 如 何 处 理 HTTP 协 议 ， 以 及 如 何 通 过 
HTTP 协 议 传输 内 容 和 数据 ， 并 且 满 足 这 两 个 要 求 只 需要 用 到 Go 语言 
本 吴 提 供 的 工具 一 一 不 需要 用 到 外 部 库 ， 也 不 需要 用 到 外 部 的 依赖 。 


在 拿 定 注意 之 后 ， 我 就 向 Manning 出 版 社 提交 了 一 个 撰写 Go 语言 
编程 书籍 的 构思 ， 这 个 构思 关注 的 是 如 何在 只 使 用 标准 库 的 情况 下 ， 
问 读 者 传授 从 去 开始 构建 Web 应 用 的 方法 ， 而 Manning 出 版 社 也 很 快 束 
同意 了 我 的 构思 并 开局 了 这 个 项 目 。 尽 管 本 书 的 拟 写 工作 持续 了 一 段 
时 间 才 得 以 完成 ， 但 是 在 写作 的 过 程 中 ， 抢 先 预 哎 版 市 来 的 反馈 忌 古 
不 断 地 璧 钴 着 我 。 最 后 ， 我 布 望 读者 能 够 像 我 至 受 创作 本 书 的 过 程 一 
样 ， 至 受 阅 读本 书 的 过 程 ， 并 且 在 这 个 过 程 中 能 够 有 所 收获 。 


致谢 


本 书 最 初 的 想法 是 在 只 使 用 标准 库 的 情况 下 教授 基本 的 Go Web 编 
程 知识 。 说 实在 的 ， 刚 开始 的 时 候 我 并 不 确定 这 个 想法 是 否 能 够 行 得 
通 ， 但 那些 花费 目 己 血汗 钱 来 购买 本 书 抢先 预 宽 版 的 读者 给 了 我 讶 励 
和 动力 来 实现 这 个 想法 ， 因 此 在 这 里 我 要 问 我 的 读者 们 致 以 诚 侧 的 感 
谢 ! 


写 书 是 一 项 团队 协作 活动 ， 尽 管 本 书 的 封面 上 只 记载 了 我 一 个 人 
的 名 字 ， 但 实际 上 大 量 幕 后 人 员 也 为 这 本 书 付出 了 目 己 的 心血 ， 他 们 
分 别 是 : 


e Marina Michaels， 来 目地 球 另 一 侧 的 一 位 勤务 且 高 效 的 编辑 ， 她 
总 是 不 知 疲倦 地 配合 我 的 工作 ， 并 且 为 了 我 们 之 间 巨 大 的 时 差 而 
不 断 地 调整 目 己 的 日 程 表 ; 


Manning 出 版 社 的 相关 工作 人 员 : 文字 编辑 Liz Welch 和 校对 
Elizabeth Martin， 他 们 的 火眼金睛 让 错误 无 处 可 藏 ， 负 员 营 销 和 
推广 本 书 的 Candace Gillhoolley 和 Ana Romac， 以 及 将 我 的 原稿 变 
为 本 书 的 Kevin Sullivan 和 Janet Vail; 


Jimmy Frasch6 对 我 的 原稿 进行 了 一 次 完整 的 技术 校对 ， 而 我 的 审 


稿 人 Alex Jacinto ` Alexander Schwartz ` Benoit Benedetti ` Brian 


Cooksey ` Doug Sparling ` Ferdinando Santacroce ` Gualtiero 


Testa ` Harry Shaun Lippy ` James Tyo ` Jeff Lim ` Lee Brandt ` 


Mike Bright ` Quintin Smith ` Rebecca Jones > Ryan Pulling ` Sam 
Zaydel 和 Wes Shaddix 则 在 撰写 原稿 的 4 个 阶段 中 为 我 提供 了 大 量 有 
价值 的 反馈 


。 这 本 书 的 抢先 预 宽 版 一 经 释 出 ， 我 在 新 加 坡 Go 社 区 的 朋友 们 就 担 
不 及 待 地 把 它 同 全 世界 广 而 告 之 了 ， 特 别 值得 一 提 的 是 Kai 
Hendry， 他 为 本 书 制作 了 一 个 详细 的 评论 视频 。 


另外 ， 我 还 要 感谢 Go 的 创造 者 Robert Griesemer ` Rob Pike 和 Ken 
Thompson， 以 及 netVhttp »html/template 等 Web 标 准 库 的 开发 
者 ， 特 别 是 Brad Fitzpatrick, WATTS BOTH, ASSL ANT RE 
现 。 


最 后 ， 也 是 最 必 不 可 少 的 ， 我 要 感谢 我 的 家 人 ， 包 括 我 杀 爱 的 妻 
子 Wooi Ying， 以 及 在 吴 高 方面 后 来 后 上 的 我 的 儿子 Kai Wen ° REA 
目 己 能 够 通过 创作 这 本 书 给 他 市 来 局 发 ， 我 也 希望 他 会 目 聚 地 阅读 这 
本 书 ， 并 从 中 有 所 收获 。 


关于 本 书 


本 书 将 完整 地 介绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概 
念 ， 并 且 在 这 个 过 程 中 只 使 用 Go 语言 目 市 的 标准 库 。 尽 管 本 书 的 部 分 
章节 会 对 其 他 库 以 及 其 他 主题 进行 讨论 ， 比 如 如 何 测试 Web 应 用 以 及 
如 何 部 署 Web 应 用 ， 但 本 书 的 主要 目的 还 是 教 读者 如 何在 只 使 用 Go 标 
准 库 的 情况 下 进行 Web 开 发 。 


本 书 要 求 读者 具备 基本 的 Go 编程 拉 能 并 掌握 Go 语言 的 语法 。 如 果 
读者 不 具备 这 些 知识 ， 可 以 阅读 由 William Kennedy ` Brian Ketelsen 和 
Erik St. Martin 创 作 的 Go in Action (1 一 书 ， 该 书 也 是 由 Manning 出 版 社 
出 版 的 。 由 Addison-Wesley 出 版 社 出 版 、Alan Donovan 和 Brian 
Kernighan 创作 的 The Go Programming Language 中 也 是 一 本 值得 一 读 
的 好 书 。 除 了 以 上 提 到 的 两 本 书 之 外 ， 网 上 也 有 非常 多 免费 的 Go 教程 
可 供 浏览 ， 比 如 ，Go 官 方 网 站 的 《Go 入 门 教程 》 (A Tour of Go) 

(http://tour.golang.org/) 就 是 一 个 很 棒 的 例子 。 


内 容 编排 


本 书 由 10 革 和 一 个 附 邓 组 成 。 


第 1 章 会 介绍 使 用 Go 开发 Web 应 用 的 方法 ， 并 阐述 这 种 做 法 的 优点 
所 在 。 除 此 之 外 ， 本 章 还 会 对 HITP 协 议 等 构成 Web 应 用 的 关键 概念 做 
深入 浅 出 的 介绍 。 


RIMS RIED ATEN, He Se KANE “id A E 
论坛 ， 以 此 来 癌 读者 展 示 如 何 使 用 Go 构建 一 个 典型 的 Web 应 用 。 


第 3 半 会 更 加 详细 地 展示 使 用 net/http 包 接收 HTTP 请 求 的 方法 。 读 
者 将 学 会 如 何 编写 Go Web 服 务 右 监 昕 HTTP 请 求 ， 以 及 如 何 使 用 处 理 
妖 和 人 处理 器 琅 数 处 理 这 些 请 求 。 


第 4 章 会 继续 介绍 处 理 HTTP 请 求 的 相关 细节 ， 重 点 讲述 Go 十 如 何 
处 理 请 求 并 返回 啊 应 的 。 除 此 之 外 ， 读 者 还 将 学 会 如 何 从 HTML 表 单 
中 获取 数据 以 及 如 何 使 用 cookie ° 


第 5 章 将 会 介绍 由 text/template 库 和 html/template 库 组 
成 的 Go 模板 引 警 。 读 者 将 会 看 到 Go 提供 的 各 种 模板 机 制 ， 并 学 会 如 何 
使 用 Go 的 布局 (layout) 。 


第 6 章 将 会 对 Go 的 存储 策略 进行 讨论 。 读 者 将 学 会 如 何 通 过 结构 
将 数据 存储 到 内 存 里 面 ， 如 何 通 过 CSV 格 式 以 及 gob 二 进 制 格式 将 数据 
存储 到 文件 系统 里 面 ， 以 及 如 何 通过 SQL 和 SQL 映射 句 去 访问 关系 数 
据 库 。 


第 7 章 将 展示 使 用 Go 语言 构建 Web 服 务 的 方法 。 读 者 不 仅 会 学 到 如 
何 使 用 Go 语言 构建 一 个 简单 的 Web 服务 ， 还 会 学 到 如 何 使 用 Go 语言 创 
建 并 分 析 XMIL 数 据 和 JSON 数 据 。 


第 8 章 将 回 读 者 传授 在 不 同 层 级 中 测试 Go Web 应 用 的 不 同方 法 ， 
其 中 包括 单元 测试 、 基 准 测 试 以 及 HTTP 测 试 ， 除 此 之 外 ， 这 一 革 还 会 
简单 介绍 几 个 第 三 方 测试 库 。 


第 9 章 会 介绍 在 Web 应 用 中 使 用 Go 语言 的 并 发 特性 的 方法 。 读 者 将 
会 了 解 到 Go 语言 的 各 个 并 发 特性 ， 并 学 会 如 何 使 用 这 些 特性 提高 一 个 
像 生成 Web 应 用 的 性 能 。 


第 10 章 是 本 书 的 最 后 一 章 ， 它 将 展示 Go Web 应 用 的 部 署 方法 。 读 
者 将 会 学 到 如 何 把 应 用 部 署 到 独立 的 服务 右上， 如 何 把 应 用 部 署 到 
Heroku、Google App Engine 之 类 的 云 平 台 上 ， 以 及 如 何 把 应 用 部 署 到 
Docker# 48 Œ H ° 


最 后 ， 本 书 的 附录 会 展示 在 不 同 平台 上 安 闭 和 设置 Go 环境 的 方 
法 。 


代码 的 约定 以 及 下 载 


本 书 通过 代码 清单 以 及 正文 内 风 的 方式 展示 了 大 量 源 代码 。 为 了 
跟 一 般 的 正文 区 别 开 来 ， 书 中 的 源 代码 都 会 使 用 等 宽 字 体 。 为 了 凸显 
某 些 代码 在 不 同 章节 之 间 的 区 别 ， 又 或 者 为 了 强调 正文 中 讨论 的 茶 些 
代码 ， 本 书 有 时 候 也 会 以 加 粗 的 方式 显示 代码 。 


除 此 之 外 ， 本 书 的 电子 书 还 会 使 用 彩色 字体 来 凸显 代码 命令 以 及 
代码 输出 : 


curl -i 127.0.0.1:8080/write 
HTTP/1.1 200 OK 


Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 
Content-Type: text/html; charset=utf-8 


<html> 
<head><title>Go Web Programming</title></head> 
<body><h1>Hello World</h1></body> 


</html> 


本 书展 示 的 所 有 代码 都 可 以 在 www.manning.com/books/go-web- 
programming 和 github.com/ sausheong/gwp 找 到 [3] o 


作者 简介 


FBIKME (Sau Sheong Chang) ， 现 任 新 加 坡 能 源 有 限 公 司 数 字 技 
术 总 裁 ， 在 此 之 前 他 曾经 担任 过 PayPal 的 消费 者 工程 经 理 。Sau 是 Ruby 
社区 和 Go 社区 一 位 活跃 的 贡献 者 ， 除 了 创作 书籍 之 外 ， 他 还 为 开源 项 
目 提交 代码 ， 并 在 各 种 技术 研讨 会 和 技术 会 议 上 发 言 。 


pc 


作者 在 线 论 坛 


购买 本 书 英 文 版 的 读者 可 以 免费 地 访问 由 Manning 出 版 社 开 设 的 
私有 Web 论 坛 ， 可 以 在 论坛 里 面 撰写 书评 、 提 出 技术 问题 并 接受 来 目 
作者 和 其 他 读者 的 帮助 。 为 了 访问 并 订阅 论坛 ， 需 要 先 使 用 浏 贤 需 访 
问 www.manning.com/books/go-web-programming， 这 个 页 面 会 告诉 读 
者 注册 账号 和 访问 论坛 的 方法 ， 除 此 之 外 ， 该 页 面 还 列举 了 论坛 提供 
的 各 种 帮助 以 及 论坛 的 各 项 规章 制度 。 


Manning 出 版 社 承 诺 为 读者 提供 论坛 作为 场所 ， 以 便 读 者 之 间 以 
及 读者 和 作者 之 间 可 以 进行 有 意义 的 对 话 ， 但 Manning 并 不 保证 作者 


的 参与 程度 一 一 作者 对 论坛 的 任何 页 献 都 是 目 愿 并 且 无 偿 的 ， 因 此 读 
者 应 该 尽 可 能 地 提出 一 些 具 有 挑战 性 的 问题 以 便 引 起 作者 的 兴趣 。 


只 要 本 书 仍 在 正 芝 销售 ， 本 书 的 作者 在 线 论 坛 以 及 论坛 上 已 有 的 
帖子 整 会 一 直 可 供 访问 。 


[1] Go in Action 的 中 文 版 已 由 人 民 邮 电 出 版 社 出 版 ， 中 文 版 书 名 为 
《Go 语言 实战 》。 一 一 译 者 注 


[2] The Go Programming Language 的 中 文 版 已 由 机 械 工 业 出 版 社 出 
版 ， 中 文 版 书 名 为 《Go 程序 设计 语言 》。 一 一 译 者 注 


[3] 本 书展 示 的 所 有 代码 也 可 以 在 异步 社区 (www.epubit.com.cn) 中 本 
书页 面 免费 下 载 。 一 编者 注 


关于 封面 插图 


本 书 的 封面 插图 系 Paolo Mercuri (1804—1884) 所 作 ， 标 题 为 “ 罕 
着 中 世纪 服装 的 男人 ”， 该 插图 来 源 于 Camille Bonnard 搜 集 并 编辑 的 
Costumes Historiques (服装 史 ) 多 卷 本 ， 该 书 于 19 世 纪 50 或 60 年 代 在 
巴黎 出 版 ， 它 搜集 了 大 量 12 世 纪 、13 世 纪 、14 世 纪 和 15 世 纪 的 历史 服 
装 。 随 着 异国 风情 和 历史 文明 在 19 世 纪 风 靡 ， 人 们 开始 着 迷 于 这 类 服 
装 收藏 本 ， 并 夭 此 去 探索 目 己 所 在 的 世界 以 及 已 经 远 去 的 旧 世 界 。 


在 这 一 历史 画册 中 ，Mercuri 丰 富 多 彩 的 画作 让 我 们 生动 地 回想 起 
了 数 百年 前 ， 世 界 各 地 不 同城 市 和 地 区 之 间 的 文化 差异 。 无 论 是 在 街 
道 还 是 乡间 ， 仪 仅 通 过 人 人们 的 着 闭 束 可 以 八 九 不 离 十 地 辨识 他 们 的 社 
会 地 位 、 从 事 的 行业 和 职业 。 在 经 历 了 数 个 世纪 的 变迁 以 后 ， 人 们 的 
着 痛 方 式 已 经 发 生 了 很 大 的 变化 ， 当 初 丰富 多 彩 的 地 区 多 样 性 也 已 逐 
渐 消失 。 时 至 今日 ， 仅 仅 通过 着 朔 已 经 很 难 区 分 不 同 大 洲 的 居民 了 ， 
更 别 说 想 要 知道 他 们 所 在 的 国家 和 城市 、 知 悉 他 们 的 社会 地 位 和 职业 
了 。 乐 观 地 讲 ， 也 许 我 们 已 经 放弃 了 追求 文化 上 的 多 样 性 ， 转 为 拥抱 
更 丰 宦 多 彩 也 更 快 节 奏 的 技术 生活 了 。 


在 计算 机 书籍 正在 变 得 越 来 越 相 似 、 越 来 越 同 质 化 的 今天 ， 
Manning 出 版 社 希 望 通过 Mercuri 的 作品 ， 将 数 个 世纪 以 前 丰富 多 彩 的 
地 区 生活 融入 图 书 封面 ， 以 此 来 赞美 计算 机 行业 不 断 创 新 和 敢 为 人 移 
的 精神 。 


第 一 部 分 Go 与 Web 应 用 


Web 应 用 是 当今 使 用 最 为 广泛 的 一 类 软件 应 用 ， 连 接 至 互联 网 的 
人 们 基本 上 每 天 都 在 使 用 Web 应 用 。 因 为 很 多 看 上 去 像 是 原生 应 用 的 
移动 应 用 都 在 内 部 包含 了 使 用 Web 技 术 构 建 的 组 件 ， 所 以 使 用 移动 设 
备 的 人 们 实际 上 也 十 在 使 用 Web 应 用 。 


因为 编写 Web 应 用 必须 对 HTTP 有 所 了 解 ， 所 以 接 下 来 的 两 革 将 对 
HTTP 进 行 介绍 。 除 此 之 外 ， 我 们 还 会 了 解 到 使 用 Go 语言 编写 Web 应 用 
的 优点 ， 并 且 实 际 使 用 Go 语言 来 构建 一 个 简单 的 网 上 论坛 ， 然 后 乌 隔 
Web 应 用 的 各 个 组 成 部 分 。 


第 1 章 Go 与 Web 应 用 


本 章 主要 内 容 


。 Web 应 用 的 定义 

。 使 用 Go 语言 编写 Web 应 用 的 优点 

e Web 应 用 编程 的 基本 知识 

。 使 用 Go 语言 编写 一 个 极为 简单 的 web 应 用 


Web 应 用 在 我 们 的 生活 中 无 处 不 在 。 看 看 我 们 日 常 使 用 的 各 个 应 用 
程序 ， 它 们 要 么 是 Web 应 用 ， 要 么 是 移动 App 这 类 Web 应 用 的 变种 。 无 
论 哪 一 种 编程 语言 ， 只 要 它 能 够 开发 出 与 人 类 交互 的 软件 ， 它 就 必然 
会 文 持 Web 应 用 开发 。 对 一 门 轩 新 的 编程 语言 来 说 ， 它 的 开发 者 首 移 要 
做 的 一 件 事 ， 就 是 构建 与 互联 网 (internet) 和 万 维 网 (World Wide 
Web) 交互 的 库 (library) 和 框架 ， 而 那些 更 为 成 熟 的 编程 语言 还 会 有 
各 种 五 伦 八 门 的 Web 开 发 工具 。 


Go 是 一 门 刚 开 始 畦 露头 角 的 语言 ， 它 是 为 了 让 人 们 能 够 简单 且 高 
效 地 编写 后 端 系统 (back end system) 而 创建 的 。 这 门 语言 拥有 众多 先 
进 的 特性 ， 并 且 密 切 关 注 程序 员 的 生产 力 以 及 各 种 与 速度 相关 的 事 
项 。 和 其 他 语言 一 样 ，Go 语 言 也 提供 了 对 Web 编 程 的 文 持 。 目 从 问世 
以 来 ，Go 语 言 在 编写 Web 应 用 以 及 “x 即 服务 系统 ” (*-as-a-service 
system) 方面 就 受到 了 热烈 追捧 。 


本 章 接 下 来 将 列举 一 些 使 用 Go 编写 web 应 用 的 优点 ， 并 介绍 一 些 
天 于 Web 应 用 的 基本 知识 。 


1.1 使 用 Go 语言 构建 Web 应 用 


“为 什么 要 使 用 Go 语言 编写 Web 应 用 呢 ? ”作为 本 书 的 读者 ， 我 想 
你 肯定 很 想 知 道 这 个 问题 的 答案 。 本 书 是 一 本 教 人 们 如 何 使 用 Go 语言 
进行 Web 编 程 的 图 书 ， 而 作为 本 书 的 作者 ， 我 的 任务 束 是 癌 你 解释 为 什 
么 人 们 会 使 用 Go 语言 进行 Web 编 程 。 本 书 将 在 接 下 来 的 内 容 中 陆续 介 
绍 Go 语言 在 Web 开 发 方面 的 优点 ， 我 袁 心 地 布 望 你 也 能 够 对 这 些 优点 
有 感同身受 的 想法 。 


Go 是 一 | 相对 比较 年 轻 的 编程 语言 ， 它 拥有 渗 采 并 且 仍 在 不 断 成 
长 的 社区 ， 并 且 它 也 非常 适合 用 来 编写 那些 需要 快速 运行 的 服务 器 端 
程序 。 因 为 Go 语言 提供 了 很 多 过 程式 编程 语言 的 特性 ， 所 以 拥有 过 程 
式 编 程 语 言 使 用 经 验 的 程序 员 对 Go 应 该 都 不 会 感到 陌生 ， 但 与 此 同 
时 ，Go 语 言 也 提供 了 函数 式 编 程 方面 的 特性 。 除 了 内 置 对 并 发 编程 的 
文 持 之 外 ，Go 语 言 还 拥有 现代 化 的 包 管 理 系统 、 垃 圾 收集 特性 以 及 一 
系列 包罗 万象 、 威 力 强 大 的 标准 库 。 


虽然 Go 目 市 的 标准 库 已 经 非常 丰富 和 安 大 了 ， 但 Go 仍然 拥有 许多 
质量 上 乘 的 开源 库 ， 它 们 可 以 对 标准 库 不 足 的 地 方 进行 补充 。 本 书 在 
大 部 分 情况 下 都 会 尽 可 能 地 使 用 标准 库 ， 但 是 偶尔 也 会 使 用 一 些 第 三 
方 开源 库 ， 以 此 来 展示 开源 社区 提供 的 一 些 另 辟 踩 径 并 且 富 有 创意 的 
方法 。 


使 用 Go 语言 进行 Web 开 发 正 变 得 日 益 流 行 ， 很 多 公司 都 已 经 开始 
使 用 Go 了 ， 其 中 包括 Dropbox、SendGrid 这 样 的 基础 设施 公司 ，Square 
和 Hailo 这 样 的 技术 驱动 的 公司 ， 甚 至 是 BBC、 纽 约 时 报 这 样 的 传统 公 
司 。 


在 开发 大 规模 Web 应 用 方面 ，Go 语 言 提供 了 一 种 不 同 于 现 有 语言 
和 平台 但 又 切实 可 行 的 方案 。 大 规模 可 扩展 的 Web 应 用 通常 需要 具备 以 
PFE: 


。 可 扩展 ; 
。 模块 化 ; 
e 可 维护 ; 


。 高 性 能 ° 
接 下 来 的 几 小 节 将 分 别 对 这 些 特质 进行 讨论 。 
1.1.1 Go 与 可 扩展 Web 应 用 


大 规模 的 Web 应 用 应 该 是 可 扩展 的 (scalable) ， 这 意味 着 应 用 的 
管理 着 应 该 能 够 测 单 、 快 速 地 提升 应 用 的 性 能 以 便 处 理 更 多 请 求 。 如 
果 一 个 应 用 是 可 扩展 的 ， 那 么 它 束 是 线性 的 ， 这 意味 着 应 用 的 管理 者 
可 以 通过 添加 更 多 人 硬件 来 获得 更 强 的 请 求 处 理 能 


有 两 种 方式 可 以 对 性 能 进行 扩展 : 


。 一 种 是 垂直 扩展 (vertical scaling) ， 即 提升 单 台 设备 的 CPU 数量 
或 者 性 能 ; 


© 男 一 种 则 是 水 平 扩展 (horizontal scaling) ， 即 通过 增加 计算 机 的 
数量 来 提升 性 能 。 


因为 Go 语言 拥有 非常 优 寞 的 并 发 编程 文 择 ， 所 以 它 在 垂直 扩展 方 
面 拥 有 不 俗 的 表现 ， 一 个 Go Web 应 用 只 需要 使 用 一 个 操作 系统 线程 
(OS thread) ， 束 可 以 通过 调度 来 高 效 地 运行 数 十 万 个 goroutine ° 


跟 其 他 Web 应 用 一 样 ，Go 也 可 以 通过 在 多 个 Go Web 应 用 之 上 架设 
代理 来 进行 高 效 的 水 平 扩展 。 因 为 Go Web 应 用 都 会 被 编译 为 不 包含 任 
何 动态 依赖 天 系 的 静态 二 进 制 文件 ， 所 以 我 们 可 以 把 这 些 文件 分 发 到 
没有 安 狼 Go 语言 的 系统 里 ， 从 而 以 一 种 简单 且 一 致 的 方式 部 署 Go Web 
MH e 


1.1.2 ”Go 与 模块 化 web 应 用 


大 规模 Web 应 用 应 该 由 可 替换 的 组 件 构成 ， 这 种 做 法 能 够 使 开发 者 
更 容易 添加 、 移 除 或 者 修改 特性 ， 从 而 更 好 地 满足 程序 不 断 变 化 的 需 
求 。 除 此 之 外 ， 这 种 做 法 的 另 一 个 好 处 是 使 开发 者 可 以 通过 复 用 模块 
化 的 组 件 来 降低 软件 开发 所 需 的 费用 。 


尽管 Go 是 一 门 静 态 类 型 语言 ， 但 用 户 可 以 通过 它 的 接口 机 制 对 行 
为 进行 描述 ， 以 此 来 实现 动态 类 型 匹配 (dynamic typing) 。Go 语 言 的 
函数 可 以 接受 接口 作为 参数 ， 这 意味 着 用 户 只 要 实现 了 接口 所 需 的 方 
法 ， 就 可 以 在 继续 使 用 现 有 代码 的 同时 向 系统 中 引入 新 的 代码 。 与 此 
同时 ， 因 为 Go 语言 的 所 有 类 型 都 实现 了 空 接口 ， 所 以 用 户 只 需要 创建 
出 一 个 接受 衬 接 口 作为 参数 的 函数 ， 残 可 以 把 任何 类 型 的 值 用 作 该 函 
数 的 实际 参数 。 此 外 ，Go 语 言 还 实现 了 一 些 在 函数 式 编 程 中 非常 常见 


的 特性 ， 其 中 包括 函数 类 型 、 使 用 函数 作为 值 以 及 财 包 ， 这 些 特性 允 
许 用 户 使 用 已 有 的 函数 来 构建 新 的 函数 ， 从 而 帮助 用 户 构建 出 更 为 模 
块 化 的 代码 。 


Go 语言 也 经 常会 被 用 于 创建 微服 务 (microservice) 。 在 微服 务 架 
构 中 ， 大 型 应 用 通常 由 多 个 规模 较 小 的 独立 服务 组 合 而 成 ， 这 些 独立 
服务 通常 可 以 相互 奉 换 ， 并 根据 它们 各 自 的 功能 进行 组 织 。 比 如 ， 日 
志 记 好 服 务 会 被 归 类 为 系统 级 服务 ， 而 开具 账单 、 风 险 分 析 这 样 的 服 
务 则 会 被 归 类 为 应 用 级 服务 。 创 建 多 个 规模 较 小 的 Go 服务 并 将 它们 组 
合 为 单个 Web 应 用 ， 这 种 做 法 使 得 我 们 可 以 在 有 需要 的 时 候 对 应 用 中 的 
服务 进行 替换 ， 而 整个 Web 应 用 也 会 因此 变 得 更 加 模块 化 。 


1.1.3 ”Go 与 可 维护 的 Web 应 用 


和 其 他 庞大 而 复杂 的 应 用 一 样 ， 拥 有 一 个 易于 维护 的 代码 库 
(codebase) 对 大 规模 的 Web 应 用 来 说 也 是 非常 重要 的 。 这 是 因为 大 规 
模 的 应 用 通常 都 会 不 断 地 成 长 和 演化 ， 所 以 开发 者 需要 经 稼 性 地 回顾 
并 修改 代码 ， 而 修改 难 懂 、 笨 拙 的 代码 需要 花费 大 量 的 时 间 ， 并 且 隐 
含 看 可 能 会 造成 东 些 功能 无 法 正常 运作 的 风险 。 因 此 ， 确 保 源 代码 能 
够 以 适当 的 方式 组 织 起 来 并 且 具 有 民 好 的 可 维护 性 对 开发 者 来 说 束 显 
得 至 天 重要 了 。 


Go 语言 的 设计 或 励 民 好 的 软件 工程 实践 ， 它 拥有 简洁 且 极 具 可 该 
性 的 语法 以 及 灵活 且 清 晰 的 包 管理 系统 。 除 此 之 外 ，Go 语 言 还 有 一 整 
套 优秀 的 工具 ， 它 们 不 仅 可 以 增强 程序 员 的 开发 体验 ， 还 能 够 帮助 他 
们 写 出 更 具 可 读 性 的 代码 ， 比 如 以 标准 化 方式 对 Go 代码 进行 格式 化 的 
源 代码 格式 化 程序 gofmt 就 是 其 中 一 个 例子 。 


因为 Go 语言 希望 文档 可 以 和 代码 一 同 演进 ， 所 以 它 的 文档 工具 
godoc 会 对 Go 源 代码 及 其 注释 进行 语法 分 析 ， 然 后 以 HTML、 纯 文本 或 
者 其 他 多 种 格式 创建 出 相应 的 文档 。godoc 的 使 用 方法 非常 简单 ， 开 发 
者 只 需要 把 文档 写 到 源 代 码 里 面 ，godoc 就 会 把 这 些 文档 以 及 与 之 相关 
联 的 代码 提取 出 来 ， 生 成 相应 的 文档 文件 。 


除 此 之 外 ，Go 还 内 置 了 对 测试 的 支持 : gotest 工 具 会 目 动 寻 找 与 源 
代码 处 于 同一 个 包 (package) 之 内 的 测试 代码 ， 并 运行 其 中 的 功能 测 
试 和 性 能 测试 。Go 语 言 也 提供 了 Web 应 用 测试 工具 ， 这 些 工具 可 以 模 
拟 出 一 个 Web 服务器 ， 并 对 该 服务 器 生成 的 响应 (response) 进行 记 


1.1.4 ”Go 与 高 性 能 Web 应 用 


高 性 能 不 仅 意味 着 能 够 在 短 时 间 内 处 理 大 量 请 求 ， 还 意味 着 服务 
器 能 够 快速 地 对 客户 端 进 行 啊 应 ， 并 让 终端 用 户 (end user) 能 够 快速 
地 执行 操作 。 


Go 语言 的 一 个 设计 目标 就 是 提供 接近 于 C 语 言 的 性 能 ， 尽 管 这 个 
目标 目前 尚未 达成 ， 但 Go 语言 现在 的 性 能 已 经 非常 具有 竞争 力 : Go 程 
$2 MAE AAAS (native code) ， 这 一 般 意 味 着 Go 程序 可 以 运行 得 
比 解 释 型 语言 的 程序 要 快 ， 并 且 就 像 前 面 说 过 的 那样 ，Go 语 言 的 
goroutine 对 并 发 编程 提供 了 非常 好 的 支持， 这 使 得 Go 应 用 可 以 同时 处 


理 多 个 请 求 。 


希望 以 上 介绍 能 够 引起 你 对 使 用 Go 语言 及 其 平台 进行 Web 开 发 的 
兴趣 。 但 是 在 学 习 如 何 使 用 Go 进行 Web 开 发 之 前 ， 我 们 需要 移 来 了 解 


一 下 什么 是 web 应用， 以 及 它们 的 工作 原理 是 什么 ， 这 会 给 我 们 学 习 之 
后 儿 间 的 内 容 带 来 非常 大 的 帮助 。 


1.2 Web 应 用 的 工作 原理 


如 采 你 在 一 个 技术 会 议 上 辣 在 场 的 程序 员 们 提出 “什么 是 Web 应 
用 ”这 一 问题 ， 那 么 通 利 会 得 到 五 化 八 门 的 回答 ， 有 些 人 甚至 可 能 还 会 
因为 你 可 了 个 如 此 基础 的 问题 而 感到 惊讶 和 不 解 。 通 过 不 同 的 人 对 这 
个 问题 的 不 同 回答 ， 我 们 可 以 了 解 到 人 们 对 Web 应 用 并 没有 一 个 十 分 明 
确 的 定义 。 比 如 说 ，Web 服 务 算 不 算 Web 应 用 ? 因为 Web 服 务 通常 会 被 
其 他 软件 调用 ， 而 Web 应 用 则 十 为 人 类 提供 服务 ， 所 以 很 多 人 部 认为 
Web 服 务 与 Web 应 用 是 两 种 不 同 的 事物 。 但 如 采 一 个 程序 能 够 像 RSS 
feed 那 样 ， 产 生出 来 的 数据 既 可 以 被 其 他 软件 使 用 ， 又 可 以 被 人 类 理 
解 ， 那 么 这 个 程序 到 底 是 一 个 Web 服 务 还 是 一 个 Web 应 用 呢 ? 


同样 地 ， 如 果 一 个 应 用 只 会 返回 HTML 页 面 ， 但 却 并 不 对 页 面 进 行 
任何 处 理 ， 那 么 它 是 一 个 Web 应 用 吗 ? 运行 在 Web 浏 蜗 器 之 上 的 Adobe 
Flash 程 序 是 一 个 Web 应 用 吗 ? 对 于 一 个 纯 HTML5 编 写 的 应 用 ， 如 果 它 
运行 在 一 个 长 期 狂 留 于 电脑 的 浏览 硕 中 ， 那 么 它 算是 一 个 Web 应 用 吗 ? 
如 果 一 个 应 用 在 向 服务 器 发 送 请 求 时 没有 使 用 HTTP 协 议 ， 那 么 它 算是 
一 个 Web 应 用 吗 ? 大 多 数 程序 员 都 能 够 从 高 层次 的 角度 去 理解 Web 应 用 
是 什么 ， 但 是 一 旦 我 们 深入 一 些 ， 稀 试 去 探究 web 应 用 的 实现 层次 ， 事 
情 就 会 变 得 含糊 不 清 起 来 。 


从 纯粹 且 狭 隘 的 角度 来 看 ，Web 应 用 应 该 是 这 样 的 计算 机 程序 ， 它 
会 对 客户 端 发 送 的 HTTP 请求 做 出 啊 应 ， 并 通过 HTTP 曙 应 将 HTML 回 传 


PEP ° (LIER, Webb NatERWebsk ae FF PIS? 的 确 如 
此 ， 如 果 按 照 上 面 给 出 的 定义 来 看 ，Web 服 务 器 和 Web 应 用 将 没有 区 别 
: 一 个 Web 服务器 就 是 一 个 web 应 用 (如 图 1-1 所 示 ) 。 


图 1-1 Web 应 用 最 基本 的 请 求 与 响应 结构 


将 Web 服 务 絮 看 作 是 Web 应 用 的 一 个 问题 在 于 ， 像 httpd 和 Apache 这 
样 的 Web 服 务 器 都 会 监视 特定 的 目录 ， 并 在 接收 到 请 求 时 返回 位 于 该 目 
录 中 的 文件 (比如 Apache 就 会 对 docroot 目 录 进 行 监 视 ) 。 与 此 相反 ， 
Web 应 用 并 不 会 简单 地 返回 文件 ， 它 会 对 请 求 进行 处 理 ， 并 执行 应 用 程 
序 中 预先 设 定好 的 操作 (如 图 1-2 所 示 ) 。 


Web 应 用 接收 请 求 ， 执 行 
程序 指定 的 操作 ， 然 后 返回 文件 。 


图 1-2 Web 应 用 的 工作 原理 


从 以 上 观点 来 看 ， 我 们 也 许可 以 把 Web 服 务 器 看 作 是 一 种 特殊 的 
Web 应 用 ， 这 种 应 用 只 会 返回 被 请 求 的 文件 。 普 裔 来 讲 ， 很 多 用 户 都 会 
把 使 用 浏览 器 作为 客户 端的 应 用 看 作 是 Web 应 用 。 这 其 中 包括 Adobe 
Flash 应 用 、 单 页 web 应用， 甚至 是 那些 不 使 用 HITP 协 议 进行 通信 但 却 
驻 留 在 桌面 或 系统 上 的 应 用 。 


为 了 在 书 中 讨论 Web 编程 的 相关 技术 ， 我 们 必须 给 这 些 技术 一 个 明 
确 的 定义 。 下 先 ， 让 我 们 来 给 出 应 用 的 定义 。 


应 用 (application) 是 一 个 与 用 户 进 行 互动 并 帮助 用 户 执 行 指 定 活 
动 的 软件 程序 。 比 如 记 账 系统 、 人 力 资 源 系统 、 桌 面 出 版 软件 等 。 而 
Web 应 用 则 是 部 署 在 Web 之 上 ， 并 通过 Web 来 使 用 的 应 用 。 


换 名 话说 ， 一 个 程序 只 需要 满足 以 下 两 个 条 件 ， 我 们 就 可 以 把 它 
看 作 是 一 个 Web 应 用 : 


这 个 程序 必须 辐 发 送 命令 请 求 的 客户 端 返回 HTML ， 而 客户 端 则 会 
回 用 户 展 示 演 染 后 的 HTML ; 
这 个 程序 在 回 客 户 端 传送 数据 时 必需 使 用 HTTP 协 议 。 


在 这 个 定义 的 基础 上 ， 如 果 一 个 程序 不 是 向 用 户 演 染 并 展示 
HTML， 而 是 向 其 他 程序 返回 某 种 非 HTML 格 式 的 数据 ， 那 么 这 个 程序 
就 是 一 个 为 其 他 程序 提供 服务 的 Web 服 务 。 本 书 将 在 第 7 章 对 Web 服 务 
进行 更 详细 的 说 明 。 


与 大 部 分 程序 员 对 Web 应 用 的 定义 相 比 ， 上 面 给 出 的 定义 可 能 显得 
稍微 狭 陈 了 一 些 ， 但 因为 这 个 定义 消除 了 所 有 的 模糊 与 不 清晰 ， 并 使 
Web 应 用 变 得 更 加 易于 理解 ， 所 以 它 对 于 本 书 讨论 的 问题 是 非常 有 帮助 


的 。 随 着 读者 对 本 书 阅 读 的 不 断 深 入 ， 这 一 定义 将 变 得 更 为 清晰 ， 但 
是 在 此 之 前 ， 让 我 们 先 来 回顾 一 下 HTTP 协 议 的 发 展 历 程 。 


1.3 ”HTTP 简介 


HTTP 是 万 维 网 的 应 用 层 通信 协议 ，Web 页 面 中 的 所 有 数据 都 是 通 
过 这 个 看 似 简 单 的 文本 协议 进行 传输 的 。HTTP 非 常 朴素 ， 但 却 异 常 地 
强大 一 一 这 个 协议 自 20 世 纪 90 年 代 定 义 以 来 ， 至 今 只 进行 了 3 次 欠 代 修 
改 ， 其 中 HTTP 1.1 是 目前 使 用 最 为 广泛 的 一 个 版 本 ， 而 最 新 的 一 个 版 
本 则 是 HTTP 2.0， 又 称 HTTP/2。 


HTTP 的 最 初版 本 HTTP 0.9 是 由 Tim Berners-Lee 为 了 让 万 维 网 能 够 
得 以 被 采纳 而 创建 的 : 它 允 许 客户 端 与 服务 器 进行 连接 ， 并 向 服务 器 
发 送 以 空 行 (CRLF) 结尾 的 ASCII 字 符 串 请 求 ， 而 服务 器 则 会 返回 不 
带 任何 元 数据 的 HTIML 作 为 响应 。 


HTTP 0.9 之 后 的 每 个 新 版 本 实现 都 包含 了 大 量 的 新 特性 ，1996 年 
发 布 的 HTTP 1.0 就 是 由 大 量 特性 合并 而 成 的 ， 之 后 的 HTTP 1.1 版 本 于 
1999 年 发 布 ， 而 HITP 2.0 版 本 则 于 2015 年 发 布 。 因 为 目前 使 用 最 为 广 
泛 的 还 是 HTTP 1.1 版 本 ， 所 以 本 书 主要 还 是 对 HTTP 1.1 进 行 讨论 ， 但 
也 会 在 适当 的 地 方 介 绍 一 些 HTTP 2.0 的 相关 信息 。 


目 完 ， 让 我 们 通过 一 个 简单 的 定义 来 说 明 什 么 十 HTTP 。 


HTTP 是 一 种 无 状态 、 由 文本 构成 的 请 求 -响应 (request-response) 协 
议 ， 这 种 协议 使 用 的 是 客户 端 -服务 器 (client-server) 计算 模型 。 


请 求 - 啊 应 十 两 台 计 算 机 进行 通信 的 基本 方式 ， 其 中 一 台 计 算 机 会 
回 另 一 全 计算机 发 大 请求 ， 而 接收 到 请 求 的 计算 机 则 会 对 请 求 进行 啊 
应 。 在 客户 端 -服务 器 计算 模型 中 ， 发 送 请 求 的 一 方 (SF) 人 负责 应 
返回 啊 应 的 一 方 (服务 器 ) 发 起 会 话 ， 而 服务 器 则 负责 为 客户 端 提 供 
服务 。 在 HTTP 协议 中 ， 客 户 端 也 被 称 作用 户 代理 (user-agent) ， 而 
服务 占 则 通常 会 锐 称 为 Web 服 务 占 。 在 大 多 数 情 况 下 ，HTTP 客 户 并 部 


是 一 个 Web 浏 哆 器 。 


HTTP 是 一 种 无 状态 协议 ， 它 唯一 知道 的 束 十 客户 端 会 同 服 务 器 发 
送 请 求 ， 而 服务 器 则 会 向 客户 端 返 回响 应 ， 并 且 后 续 发 生 的 请 求 对 之 
前 发 生 过 的 请 求 一 无 所 知 。 相 对 的 ， 像 FTP、Telnet 这 类 面向 连接 的 协 
议 则 会 在 客户 端 和 服务 器 之 间 创 建 一 个 持续 存在 的 通信 通道 (其 中 
Telnet 在 进行 通信 时 使 用 的 也 是 请 求 - 啊 应 方式 以 及 客户 端 -服务 需 计 算 
模型 ) 。 顺 带 提 一 下 ，HTTP 1.1 也 可 以 通过 持久 化 连接 来 提升 性 能 。 


跟 很 多 互联 网 协议 一 样 ，HITP 也 是 以 纯 文 本 方式 而 不 是 二 进 制 方 
式 发 送 和 接收 协议 数据 的 。 这 样 做 是 为 了 让 开发 者 可 以 在 无 需 使 用 专 
门 的 协议 分 析 工 具 的 情况 下 ， 弄 清楚 通信 中 正在 发 生 的 事情 ， 从 而 更 
容易 进行 故障 排 碍 。 


因为 HTTP 最 初 在 设计 时 只 用 于 传送 HTML， 所 以 HTTP 0.9 只 提供 
了 GET 这 一 个 方法 (method) ， 但 新 版 本 对 HTTP 的 扩展 使 它 逐 渐变 成 
了 一 种 通用 的 协议 ， 用 户 也 得 以 将 其 应 用 于 Web 应 用 等 分 布 式 系统 
本 章 接 下 来 就 会 对 Web 应 用 进行 介绍 。 


1.4 Web 应 用 的 诞生 


在 万 维 网 出 现 不 久之 后 ， 人 们 开始 意识 到 一 点 : 尽管 使 用 Web 服 务 
回 处 理 静 态 HITML 文 件 这 个 主意 非常 棒 ， 但 如 果 HTML 里 面 能 够 包含 动 
态 生 成 的 内 容 ， 那 么 事情 将 会 变 得 更 加 有 趣 。 其 中 ， 通 用 网 天 接口 
(Common Gateway Interface, CGI) 就 是 在 早期 尝试 动态 生成 HTML 
内 容 的 技术 之 一 。 


1993 年 ， 美 国 国家 超级 计算 应 用 中 心 (National Center for 
Supercomputing Applications, NCSA) 编写 了 一 个 在 Web 服 务 器 上 调用 
可 执行 命令 行程 序 的 规范 (specification) ， 他 们 把 这 个 规范 命名 为 
CGI， 并 将 它 包 含 在 了 NCSA 开 发 的 广 受 欢迎 的 HITPd 服 务 郁 里 面 。 不 
过 NCSA 制 定 的 这 个 规范 最 终 并 没有 成 为 正式 的 互联 网 标准 ， 只 有 CGI 
这 个 名 字 人 被 后 来 的 规范 沿用 了 下 来。 


CGI 是 一 个 简单 的 接口 ， 它 允许 Web 服 务 器 与 一 个 独立 运行 于 Web 
服务 器 进程 之 外 的 进程 进行 对 接 。 通 过 CGI 与 服务 器 进行 对 接 的 程序 通 
常 被 称 为 CGI 程序 ， 这 种 程序 可 以 使 用 任何 编程 语言 编写 一 -这 也 是 我 
们 把 这 种 接口 称 之 为 “通用 ”接口 的 原因 ， 不 过 早期 的 CGI 程序 大 多 数 都 
是 使 用 Pen 语言 编写 的 。 向 CGI 程序 传递 输入 参数 是 通过 设置 环境 变量 
来 完成 的 ，CGI 程 序 在 运行 之 后 将 向 标准 输出 (stand output) 返回 结 
末 ， 而 服务 器 则 会 将 这 些 结果 传送 至 客户 端 。 


与 CGI 同期 出 现 的 还 有 服务 器 端 包含 (server-side includes, SSI) 
技术 ， 这 种 技术 允许 开发 者 在 HTML 文 件 里 面包 含 一 些 指令 
(directive) : 当 客 户 端 请 求 一 个 HTML 文 件 的 时 候 ， 服 务 器 在 返回 这 
个 文件 之 前 ， 会 先 执行 文件 中 包含 的 指令 ， 并 将 文件 中 出 现 指令 的 位 
置 奉 换 成 这 些 指令 的 执行 结果 。SSI 最 常见 的 用 法 是 在 HTML 文件 中 包 


oA EBACE, LERRA Pa eS HH EY DUET HED 
(header) 以 及 尾部 (footer) 的 代码 段 舱 入 HTML 文 件 中 。 


作为 例子 ， 以 下 代码 演示 了 如 何 通 过 SSI 指 令 将 navbar .shtml 
文件 中 的 内 容 包 含 到 HTML 文 件 中 : 


<html> 
<head><title>Example SSI</title></head> 
<body> 


<!--#include file="navbar.shtml" --> 
</body> 
</html> 


SSI 技 术 的 最 终 演 化 结果 就 是 在 HTML 里 面包 含 更 为 复杂 的 代码 ， 
并 使 用 更 为 强大 的 解释 器 (interpreter) 。 这 一 模式 衍生 出 了 PHP、 
ASP、JSP 和 ColdFusion 等 一 系列 非常 成 功 的 引擎 ， 开 发 者 通过 使 用 这 
些 引 警 能 够 开发 出 各 式 各 样 复杂 的 Web 应 用 。 除 此 之 外 ， 这 一 模式 也 是 
Mustache、ERB、Velocity 等 一 系列 Web 模 板 引 警 的 基础 。 


如 前 所 述 ，Web 应 用 是 为 了 通过 HTTP 向 用 户 发 送 定制 的 动态 内 容 
而 诞生 的 ， 为 了 乔 明 日 Web 应 用 的 运作 原理 ， 我 们 必须 知道 HTTP 的 工 
作 过 程 ， 并 理解 HTTP 请 求 和 响应 的 运作 机 制 。 


1.5 HTTP 请求 
HTTP 是 一 种 请 求 -响应 协议 ， 协 议 涉及 的 所 有 事情 都 以 一 个 请 求 开 


始 。HTTP 请 求 跟 其 他 所 有 HTTP 报 文 (message) 一 样 ， 都 由 一 系列 文 
本 行 组 成 ， 这 些 文本 行 会 按照 以 下 顺序 进行 排列 : 


(1) 请 求 行 (request-line) ; 


(2) 零 个 或 任意 多 个 请 求 首部 (header) ; 


(4) 可 选 的 报 文 主体 (body) ° 


一 个 典型 的 HTTP 请 求 看 上 去 是 这 个 样子 的 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 


User-Agent: Mozilla/5.0 
(empty line) 


XS AE PB SCAT BE ORT : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 


请 求 行 中 的 第 一 个 单词 为 请 求 方法 (request method) ， 之 后 跟着 
的 是 统一 资源 标识 符 (Uniform Resource Identifier, URI) 以 及 所 用 的 
HTTP 版 本 。 位 于 请 求 行 之 后 的 两 个 文本 行为 请 求 的 首部 。 注 意 ， 这 个 
报 文 鸭 最 后 一 行为 至 行 ， 即 使 报 文 的 主体 部 分 为 至 ， 这 个 空 行 也 必须 
存在 ， 人 至 于 报 文 是 否 包含 主体 则 需要 根据 请 求 使 用 的 方法 而 定 。 


1.5.1 WRATH 


请 求 方法 是 请 求 行 中 的 第 一 个 单词 ， 它 指明 了 客户 端 想 要 对 资源 
执行 的 操作 。HTTP 0.9 只 有 GET 一 个 方法 ，HTTP 1.0 添 加 了 POST 方法 


和 HEAD 方法 ， 而 HTTP 1.1 则 添加 了 PUT > DELETE > OPTIONS ` 
TRACE 和 CONNECT 这 5 个 方法 ， 并 允许 开发 者 上 自行 添加 更 多 方法 一 一 
很 多 人 立即 就 把 这 个 功能 付 诸 实 践 了 。 


天 于 请 求 方法 的 一 个 有 趣 之 处 在 于 ，HTTP 1.1 要 求 必须 实现 的 只 


有 GET 方法 和 HEAD 方法 ， 而 其 他 方法 的 实现 则 是 可 选 的 ， 甚 至 连 
POST 方法 也 是 可 选 的 。 


各 个 HTTP 方 法 的 作用 说 明 如 下 。 


GET 命令 服务 器 返回 指定 的 资源 。 

HEAD — 5 GET 方法 的 作用 类 似 ， 唯 一 的 不 同 在 于 这 个 方法 不 
要 求 服务 器 返 回报 文 的 主体 。 这 个 方法 通常 用 于 在 不 获取 报 文 主 
体 的 情况 下 ， 取 得 响应 的 首部 。 

POST 命令 服务 器 将 报 文 主体 中 的 数据 传递 给 URI 指 定 的 资 

源 ， 至 于 服务 器 具体 会 对 这 些 数据 执行 什么 动作 则 取决 于 服务 器 
KẸ e 

PUT 命令 服务 器 将 报 文 主体 中 的 数据 设置 为 URI 指 定 的 资源 。 
如 果 URI 指 定 的 位 置 上 已 经 有 数据 存在 ， 那 么 使 用 报 文 主体 中 的 数 
据 去 代替 已 有 的 数据 。 如 果 资 源 尚 未 存在 ， 那 么 在 URI 指 定 的 位 置 
上 新 创建 一 个 资源 。 


DELETE 命令 服务 器 删除 URI 指 定 的 资源 。 
TRACE 命令 服务 器 返回 请 求 本 身 。 通 过 这 个 方法 ， 客 户 端 可 


以 知道 介 于 它 和 服务 器 之 间 的 其 他 服务 器 是 如 何 处 理 请 求 的 。 
OPTIONS 命令 服务 絮 返 回 它 支 持 的 HTTP 方 法 列表 。 


e CONNECT 命令 服务 器 与 客户 端 建立 一 个 网 络 连接 。 这 个 方法 
通常 用 于 设置 SSL 隧 道 以 开局 HITPS 功 能 。 

。 PATCH 命令 服务 器 使 用 报 文 主体 中 的 数据 对 URI 指 定 的 资源 
进行 修改 。 


15.2 ”安全 的 请 求 方法 


如 果 一 个 HTTP 方 法 只 要 求 服务 器 提供 信息 而 不 会 对 服务 器 的 状态 
做 任何 修改 ， 那 么 这 个 方法 就 是 安全 的 (safe) ° GET > HEAD ` 
OPTIONS 和 TRACE 都 不 会 对 服务 器 的 状态 进行 修改 ， 所 以 它们 都 是 安 
全 的 方法 。 与 此 相反 ，POST > PUT 和 DELETE 都 能 够 对 服务 器 的 状态 
进行 修改 (比如 说 ， 在 处 理 POST 请 求 时 ， 服 务 器 存储 的 数据 就 可 能 会 
发 生变 化 ) ， 因 此 这 些 方法 都 不 是 安全 的 方法 。 

1.5.3 FESO RATE 

如 果 一 个 HTTP 方 法 在 使 用 相同 的 数据 进行 第 二 次 调用 的 时 候 ， 不 

会 对 服务 器 的 状态 造成 任何 改变 ， 那 么 这 个 方法 就 是 盎 等 的 
(idempotent) 。 根 据 安全 的 方法 的 定义 ， 因 为 所 有 安全 的 方法 都 不 会 
修改 服务 器 状态 ， 所 以 它们 天 生 就 是 客 等 的 。 


PUT 和 DELETE BARRE, (ARS, REANIM Et 
行 第 二 次 调用 时 都 不 会 改变 服务 器 的 状态 : 因为 服务 器 在 执行 第 一 个 
PUT 请 求 之 后 ，URI 指 定 的 资源 已 经 被 更 新 或 者 创建 出 来 了 ， 所 以 针对 
同一 个 资源 的 第 二 次 PUT 请 求 只 会 执行 服务 器 已 经 执行 过 的 动作 ; 与 
此 类 似 ， 虽然 服务 器 对 于 同一 个 资源 的 第 二 次 DELETE 请 求 可 能 会 返回 
一 个 错误 ， 但 这 个 请 求 并 不 会 改变 服务 器 的 状态 。 


相反 ， 因 为 重复 的 POST Ce Go ERS ae hace HRS as H 
TREN, MAPOST FIZ ARREARS o She MER ER 
的 概念 ， 本 书 第 7 章 在 介绍 Web 服 务 时 将 再 次 提 及 这 个 概念 。 


1.5.4 ”浏览 器 对 请 求 方法 的 支持 


GET 方法 是 最 基本 的 HTTP 方 法 ， 它 负责 从 服务 器 上 获取 内 容 ， 所 
AA ib aR ab LRAD IE © POST 方法 从 HTML 2.0 开始 可 以 通过 添加 
HTML 表 单 来 实现 : HTML 的 form 标签 有 一 个 名 为 method 的 属性 ， 
用 户 可 以 通过 将 这 个 属性 的 值 设 置 为 get 或 者 post 来 指定 要 使 用 哪 
种 方法 。 


HTML 不 支持 除 GET 和 POST 之 外 的 其 他 HTTP 方 法 : 在 HTML5 规 
范 的 早期 草案 中 ，HTML 表 单 的 method 属性 曾经 添加 过 对 PUT 方法 和 
DELETE 方法 的 文 持 ， 但 这 些 文 持 在 之 后 又 被 删除 了 。 


话 虽 如 此 ， 但 流行 的 浏览 器 通常 都 不 会 只 支持 HTML 一 种 数据 格式 
一 一 用 户 可 以 使 用 XMLHttpRequest (XHR) 来 获得 对 PUT 方法 和 
DELTE 方法 的 支持 。XHR 是 一 系列 浏览 器 API， 这 些 API 通 常 由 
JavaScript È (实际 上 XHR 就 是 一 个 名 为 XMLHttpRequest 的 浏览 器 对 
R) 。XHR 人 允许 程序 员 向 服务 器 发 送 HTTP 请 求 ， 并 且 
跟 “XMLHttpRequest” 这 个 名 字 所 上 暗示 的 不 一 样 ， 这 项 技术 并 不 仅 仅 局 
限于 XML 格式 一 一 包括 JSON 以 及 纯 文 本 在 内 的 任何 格式 的 请 求 和 响应 
都 可 以 通过 XHR 发 送 。 


155 ”请 求 首部 


HTTP 请 求 方法 定义 了 发 送 请 求 的 客户 端 想 要 执行 的 动作 ， 而 
HTTP 请 求 的 首部 则 记录 了 与 请 求 本 喘 以 及 客户 端 有 关 的 信息 。 请 求 的 
首部 由 任意 多 个 用 冒号 分 隔 的 纯 文 本 键 值 对 组 成 ， 最 后 以 回 车 (CR) 
和 换行 (LF) 结尾 。 


作为 HTTP 1.1 RFC 的 一 部 分 ，RFC 7231 对 主要 的 一 些 HTTP 请 求 字 
段 (request field) 进行 了 标准 化 。 过 去 ， 非 标准 的 HTTP 请 求 通常 以 X- 
作为 前 级 ， 但 标准 并 没有 沿用 这 一 惯例 。 


大 多 数 HTTP 请 求 首部 都 是 可 选 的 ， 宿 主 (Host) 首部 字段 是 
HTTP 1.1 唯 一 强制 要 求 的 首部 。 根 据 请 求 使 用 的 方法 不 同 ， 如 采 请 求 
的 报 文中 包含 有 可 选 的 主体 ， 那 么 请 求 的 首部 还 需要 带 有 内 容 长 度 

(Content-Length) 字段 或 者 传输 编码 (Transfer-Encoding) 字段 。 表 1- 
1 展示 了 一 些 常见 的 请 求 首部 。 


表 1-1 常见 的 HTTP 请 求 首部 


首部 字段 作用 描述 


客户 端 在 HTTP 响 应 中 能 够 接收 的 内 容 类 型 。 比 如 说 ， 客 户 端 可 以 通 
IL Accept: text/html 这 个 首部 ， 告知 服务 器 =| CA ZE v 的 十 体 
中 收 到 HTML 类 型 的 内 容 


客户 端 要 求 服 务 器 使 用 的 字符 集 编码 。 比 如 说 ， 客 户 端 可 以 通过 
Accept-Charset: utf-8 这 个 首部 ， 告 知 服务 器 自己 希望 响应 的 主体 
使 用 UTF-8 字 符 集 


stn aris 于 向 服务 器 发 送 基本 的 身份 验证 证 书 


首部 字段 作用 描述 


客户 端 应 该 在 这 个 首部 中 把 服务 器 之 前 设置 的 所 有 cookie 回 传 给 服务 
器 。 比 如 说 ， 如 果 服 务 器 之 前 在 浏览 右上 设置 了 3 个 cookie， 那 么 

Cookie Cookie 首 部 字段 将 在 一 个 字符 串 里 面包 含 这 3 个 cookie， 并 使 用 分 号 
对 这 些 cookie 进 行 分 隔 。 以 下 是 一 个 Cookie 首 部 示例 : cookie: 


my_first_cookie=hello; my_second_cookie=world 


TRE AW RE 


当 请 求 包含 主体 的 时 候 ， 这 个 首部 用 于 记录 主体 内 容 的 类 型 。 在 发 送 

POST 或 PUT 请 求 时 ， 内 容 的 类 型 默认 为 x-www-form-urlen-coded , 但 
Content-Type E DE C 

是 在 上 传 文件 时 ， 内 容 的 类 型 应 该 设置 为 mnultipart/form-data (上 

传 文件 这 一 操作 可 以 通过 将 input 标签 的 类 型 设置 为 file 来 实现 ) 


服务 器 的 名 字 以 及 端口 号 。 如 细 首部 没有 记录 服务 器 的 端口 号 ， 
Os 一 A fe a 
就 表示 服务 器 使 用 的 是 80 端 口 
sow RUSH 
ee 


16 HTTP 响应 


HTTP 响 应 报 文 是 对 HTTP 请 求 报 文 的 回复 。 跟 HTTP 请 求 
HTTP 响 应 也 是 由 一 系列 文本 行 组 成 的 ， 其 中 包括 : 


样 ， 


。 一 个 状态 行 ; 
。 和 零 个 或 任意 数量 的 啊 应 首部 ， 


NEST; 


。 一 个 可 选 的 报 文 主体 。 


也 许 你 已 经 发 现 了 ， HTTP 啊 应 的 组 织 方 式 跟 HTTP 请 求 的 组 织 
式 是 完全 相同 的 。 以 下 是 一 个 典型 的 HITP 响 应 的 样子 (为 了 节省 篇 
幅 ， 我 们 省 略 了 报 文 主体 中 的 部 分 内 容 ) : 


200 OK 
Date: Sat, 22 Nov 2014 12:58:58 GMT 
Server: Apache/2 
Last-Modified: Thu, 28 Aug 2014 21:01:33 GMT 
Content-Length: 33115 
Content-Type: text/html; charset=iso-8859-1 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"http: //www.w3.org/ 

TR/xhtm11/DTD/xhtmli-strict.dtd"> <html 
xmlns='http://www.w3.org/1999/ 

xhtml'> <head><title>Hypertext Transfer Protocol -- 
HTTP/1.1</title></ 

head><body>...</body></htm1l> 


HTTP 响 应 的 第 一 行为 状态 行 ， 这 个 文本 行 包含 了 状态 码 (status 
code) 和 相应 的 原因 短语 (reason ee 原因 短语 对 状态 码 进 行 了 
人 简单 的 接 述 。 除 此 之 外 ， 这 个 例子 中 的 HTTP 啊 应 还 包公 了 一 个 HTML 
格式 的 报 文 主体 。 


1.6.1 ”响应 状态 码 


正如 之 前 所 说 ，HTTP 啊 应 中 的 状态 码 表 明了 咖 应 的 类 型 。HTTP 
响应 状态 码 共 有 5 种 类 型 ， 它 们 分 别 以 不 同 的 数字 作为 前 级 ， 如 表 1-2 所 


情报 状态 码 。 服 务 器 
端 发 送 的 请 求 ， 并 且 


‘yE 


过 


表 1-2 HTTP 响 应 状态 码 


过 这 些 状态 码 来 告知 客户 


作用 描述 


=; 
ra ma 


重 定向 状态 码 。 这 些 状态 码 表示 服务 器 已 经 接收 到 了 客户 


,经 对 请 求 进行 了 处 理 


成 功 状 态 码 。 这 些 状态 码 说 明 服 务 器 已 经 接收 到 了 客户 端 发 送 的 请 求 ， 并 且 
已 经 成 功 地 对 请 求 进行 了 处 理 。 这 类 状态 码 的 标准 响应 为 “26@ OK” 


端 发 送 的 请 求 ， 并 


经 接收 到 了 客户 


且 已 经 成 功 处 理 了 请 求 ， 但 为 了 完成 请 求 指定 的 动作 ， 客 户 


些 其 他 工作 。 这 类 状态 码 大 多 用 于 实现 URL 重 定向 


这 一 类 型 的 状态 码 


务 器 无 法 从 请 求 指 定 的 URLT 


端 还 需要 再 做 


客户 端 错误 状态 码 。 这 类 状态 码 说 明 客 户 端 发 送 的 请 求 出 现 了 某 些 问题 。 在 


， 最 常见 的 就 是 “404 Not Found” 了 ， 这 个 状态 码 表示 服 


找到 客户 端 想 要 的 资源 


服务 器 错误 状态 码 。 当 服务 器 因为 某 些 原 因而 无 法 正确 地 处 理 请 求 时 ， 服 务 


器 束 会 使 用 这 类 状态 码 来 通知 客户 端 。 在 这 一 类 状态 码 中 ， 


是 “500 Internal Server Error” 状态 码 了 


1.6.2 ”响应 首部 


最 向 见 的 就 
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成 ， 并 且 同 样 以 回 车 (CR) 和 换行 (LF) 结尾 。 正 如 请 求 首部 能 够 告 
诉 服 务 右 更 多 与 请 求 相关 或 者 与 客户 剖 诉 求 相 关 的 信息 一 样 ， 啊 应 站 
部 也 能 够 向 客户 端 传达 更 多 与 响应 相关 或 者 与 服务 絮 〈 对 客户 端的 ) 
诉求 相关 的 信息 。 表 1-3 展 示 了 一 些 常 见 的 啊 应 首部 。 


表 1-3 ”常见 的 响应 首部 


首部 字段 作用 描述 
端 ， 服 务 器 支持 哪些 请 求 方法 


Content- ee eee ps ESTES 
响应 包含 可 选 的 主体 ， 那 么 这 个 首部 记录 的 就 是 主体 内 容 的 类 型 
ype 


以 格林 尼 治 标准 时 间 (GMT) 格式 记录 的 当前 时 间 


这 个 首部 仅 在 重 定向 时 使 用 ， 它 会 告知 客户 端 接 下 来 应 该 问 哪 个 URL 
ocation 

发 送 请 求 
返回 响应 的 服务 器 的 域名 


| 端 里 面 设 置 一 个 cookie。 一 个 响应 里 面 可 以 包含 多 个 Set-Cookie 
Set-Cookie | . 


首部 字段 作用 描述 


服务 器 通过 这 个 首部 来 告知 客户 端 ， 在 Authorization 请 求 首部 中 应 该 

提供 哪 种 类 型 的 喘 份 验 证 信息 。 服 务 器 常常 会 把 这 个 首部 与 “461 

Unauthorized” 状态 行 一 同 发 送 。 除 此 之 外 ， 这 个 首部 还 会 向 服务 器 许 

可 的 认证 授权 模式 (schema) 提供 验证 信息 (challenge information) 
(比如 RFC 2617 描 述 的 基本 和 摘要 访问 认证 模式 ) 


WWW- 


Authenticate 


1.7 URI 


Tim Berners-Lee 在 创建 万 维 网 的 同时 ， 也 引入 了 使 用 位 置 字符 串 表 

示 互 联网 资源 的 概念 。 他 在 1994 年 发 表 的 RFC 1630 中 对 统一 资源 标识 
ÍF (Uniform Resource Identifier, URI) 进行 了 7 定义。 在 这 篇 RFC 中 ， 
他 描述 了 一 种 使 用 字符 串 表 示 资 源 名 字 的 方法 ， 以 及 一 种 使 用 字符 串 
表示 资源 所 在 位 置 的 方法 ， 其 中 前 一 种 方法 被 称 为 统一 资源 名 称 

(Uniform Resource Name, URN) ， 而 后 一 种 方法 则 被 称 为 统一 资源 
定位 符 (Uniform Resource Location, URL) 。URI 是 一 个 涵盖 性 术 
语 ， 它 包含 了 URN 和 URL， 并 且 这 两 者 也 拥有 相似 的 语法 和 格式 。 
为 本 书 只 会 对 URL 进 行 讨论 ， 所 以 本 书 中 提 及 的 URI 指 代 的 都 是 URL ° 


URI 的 一 般 格式 为 : 


< 方案 名 称 > : < 分 [ ? < 查询 参数 > ] [ # < 片段 > ] 


URI 中 的 方案 名 称 (scheme name) 记录 了 URI 下 在 使 用 的 方案 ， 
它 定 义 了 URI 其 余部 分 的 结构 。 因 为 URI 是 一 种 非常 常用 的 资源 标识 方 


式 ， 所 以 它 拥 有 大 量 的 方案 可 供 使 用 ， 不 过 本 书 在 大 多 数 情况 下 只 会 
使 用 HTTP 方 案 。 


sk SS 


URI 的 分 层 部 分 (hierarchical part) 包含 了 资源 的 识别 信息 ， 这 些 
言 息 会 以 分 层 的 方式 进行 组 织 。 如 果 分 层 部 分 以 双 和 斜 线 (// ) FA, 
那么 说 明 它 包含 了 可 选 的 用 户 信息 ， 这 些 信 息 将 以 @ 符号 结尾 ， 后 跟 分 
层 路 径 。 不 带 用 户 信息 的 分 层 部 分 就 是 一 个 单纯 的 路 径 ， 每 个 路 径 都 
由 一 连 串 的 分 段 (segment) 组 成 ， 各 个 分 段 之 间 使 用 单 斜 线 (/ ) 分 


隔 。 


在 URI 的 各 个 部 分 当中 ， 只 有 “方案 名 称 ” 和 “分 层 部 分 ”是 必需 的 。 
以 问号 (2) 为 前 级 的 查询 参数 (query) 是 可 选 的 ， 这 些 参数 用 于 包 
侣 无 法 使 用 分 技 方式 表示 的 其 他 信息 。 多 个 查询 参数 会 被 组 织 成 一 连 
串 的 键 值 对 ， 各 个 键 值 对 之 间 使 用 & 符号 分 隔 。 


URI 的 另 一 个 可 选 部 分 为 片段 (fragment) ,片段 使 用 并 号 (4) 
作为 前 级 ， 它 可 以 对 URI 定 义 的 资源 中 的 次 级 资源 (secondary 
resource) 进行 标识 。 当 URI 包 含 查询 参数 时 ，URI 的 片段 将 被 放 到 查询 
参数 之 后 。 因 为 URI 的 片段 是 由 客户 端 负 责 处 理 的 ， 所 以 Web 浏 砚 硕 在 
将 URI 发 送 给 服务 器 之 前 ， 一 般 都 会 先 把 URI 中 的 厂 段 移 除 掉 。 如 果 程 
序 员 想 要 取得 URI 片 段 ， 那 么 可 以 通过 JavaScript 或 者 某 个 HTTP 客 户 端 
库 ， 将 URI 片 段 包含 在 一 个 GET 请 求 里 面 。 


让 我 们 来 看 一 个 使 用 HTTP 方 案 的 URI 示 例 : 
http://sausheong:password@www.example. com/ docs/file? 


name=sausheong&location=singapore#summary ° 


这 个 URI 使 用 的 是 http 方案 ， 跟 在 方案 名 之 后 的 是 一 个 冒号 。 位 
于 @ 符号 之 前 的 分 段 sausheong:password 记录 的 是 用 户 名 和 密码 ， 而 跟 
在 用 户 信 息 之 后 的 www.example.com/docs/file 就 是 分 层 部 分 的 其 余部 
分 。 位 于 分 层 部 分 最 高 层 的 是 服务 器 的 域名 www.example.com， 之 后 跟 
着 的 两 个 层 分 别 为 doc 和 fle， 每 个 分 层 之 间 都 使 用 单 笠 线 分 隔 。 跟 在 分 
层 部 分 之 后 的 是 以 问号 (? ) 为 前 组 的 查询 参数 ， 这 个 部 分 包含 了 
name=sausheong 和 location=singapore 这 两 个 键 值 对 ， 键 值 对 之 间 使 用 一 
个 & 符号 连接 。 最 后 ， 这 个 URI 的 末尾 还 带 有 一 个 以 井 号 (+) 为 前 组 
HJT ER ° 
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含 空格 的 。 此 外 ， 因 为 问号 (2) 和 并 号 (4) 等 符号 在 URL 中 具有 特 
殊 的 售 义 ， 所 以 这 些 符号 古 不 能 够 用 于 其 他 用 途 的 。 为 了 避 开 这 些 限 
制 ， 我 们 需要 使 用 URL 编 码 来 对 这 些 特殊 符号 进行 转换 (URLA X 
称 百 分 号 编码 ) 。 


RFC 3986 定 义 了 URL 中 的 保留 字符 以 及 非 保 留 字符 ， 所 有 保留 字 
符 都 需要 进行 URL 编 码 : URL 编 码 会 把 保留 字符 转换 成 该 字符 在 ASCII 
编码 中 对 应 的 字 节 值 (byte value) ， 接 着 把 这 个 字 节 值 表示 为 一 个 两 
位 长 的 十 六 进 制 数字 ， 最 后 再 在 这 个 十 六 进 制 数字 的 前 面 加 上 一 个 百 
分 号 (%) 。 


比如 说 ， 至 格 在 ASCI 编 码 中 的 字 节 值 为 922， 也 怠 是 十 六 进 制 中 的 
20。 因 此 ， 经 过 URL 编 码 处 理 的 空格 速成 了 %20 ，URL 中 的 所 有 空格 
都 会 补 蔡 换 成 这 个 值 。 比 如 在 接 下 来 展示 的 这 个 URL 里 面 ， 用 户 名 sau 
和 sheong 之 间 的 空格 职 被 奉 换 成 了 %20 : 


http://www.example.com/docs/file? 


name=sau%20sheong&location=singapore ° 
1.8 HTTP/2 简 介 


HTTP/2 是 HTTP 协 议 的 最 新 版 本 ， 这 一 版 本 对 性 能 非常 关注 。 
HTTP/2 协 议 由 SPDY/2 协 议 改 进而 来 ， 后 者 最 初 是 Google 公 司 为 了 传输 
Web 内 容 而 开发 的 一 种 开放 的 网 络 协 议 。 


与 使 用 纯 文 本 方式 表示 的 HITP 1.x 不 同 ，HTTP/2 是 一 种 二 进 制 协 
W: 二 进 制 表示 不 仅 能 够 让 HTTP/2 的 语法 分 析 变 得 更 为 高 效 ， 还 能 够 
让 协议 变 得 更 为 紧 炭 和 健壮 ; 但 与 此 同时 ， 对 那些 习惯 了 使 用 HTTP 
1.x 的 开发 者 来 说 ， 他 们 将 无 法 再 通过 telnet 等 应 用 程序 直接 发 送 HTTP/2 
报 文 来 进行 调试 。 


跟 HTTP 1.x 在 一 个 网 络 连接 里 面 每 次 只 能 发 送 单个 请 求 的 做 法 不 
同 ，HTTP/2 是 完全 多 路 复 用 的 (fully multiplexed) ， 这 意味 着 多 个 请 
求 和 响应 可 以 在 同一 时 间 内 使 用 同一 个 连接 。 除 此 之 外 ，HTTP/2 还 会 
对 首部 进行 压缩 以 减少 需要 传送 的 数据 量 ， 并 允许 服务 器 将 响应 推送 
(push) 至 客户 端 ， 这 些 措施 都 能 够 有 效 地 提升 性 能 。 


因为 HTTP 的 应 用 范围 是 如 此 的 广泛 ， 对 语法 的 任何 贸然 修改 都 有 
可 能 会 对 已 有 的 Web 造 成 破坏 ， 所 以 尽管 HTTP/2 对 协议 的 通信 性 能 进 
行 了 优化 ， 但 它 并 没有 对 HTTP 协 议 本 身 的 语法 进行 修改 : 在 HITP/2 
中 ，HTTP 方 法 和 状态 码 等 功能 的 语法 还 是 跟 HTTP 1.1 时 一 样 。 


在 Go 1.6 版 本 中 ， 用 户 在 使 用 HTTPS 时 将 自动 使 用 HTTP/2， 而 Go 
1.6 之 前 的 版 本 则 在 golang ,org/x/net/http2 包 里 面 实现 了 
HTTP/2 协 议 。 本 书 的 第 3 章 将 会 介绍 如 何 使 用 HTTP/2。 


1.9 Web 应 用 的 各 个 组 成 部 分 


通过 前 面 的 介绍 ， 我 们 知道 了 Web 应 用 就 是 一 个 执行 以 下 任务 的 程 


序 : 
(1) 通过 HTTP 协 议 ， 以 HTTP 请 求 报 文 的 形式 获取 客户 端 输入 ; 
(2) 对 HTTP 请 求 报 文 进行 处 理 ， 并 执行 必要 的 操作 ; 
(3) 生成 HIML， 并 以 HTTP 响 应 报 文 的 形式 将 其 返回 给 客户 端 。 
为 了 完成 这 些 任务 ，Web 应 用 被 分 成 了 处 理 器 (Chandler) 和 模板 
引擎 (template engine) 这 两 个 部 分 。 
1.9.1 ”处理 器 


Web] H HAIN EE ir 除了 要 接收 和 处 理 客户 端 发 来 的 请 求 ， 还 需 
要 调用 模板 引擎 ， 然 后 由 模板 引擎 生成 HTML 并 把 数据 填充 至 将 要 回 传 
给 客户 端的 啊 应 报 文 当中 。 


用 MVC 模 式 来 讲 ， 处 理 器 既是 控制 器 (controller) ， 也 是 模型 
(model) 。 在 理想 的 MVC 模 式 实现 中 ， 控 制 器 应 该 是 “苗条 的 "， 它 应 
该 只 包含 路 由 (routing) 代码 以 及 HTTP 报 文 的 解 包 和 打包 逻辑 ， 而 模 
型 则 应 该 是 “丰满 的 "， 它 应 该 包含 应 用 的 逻辑 以 及 数据 。 


用 “模型 -视图 -控制 器 "模式 


模型 -视图 -控制 器 (Model-View-Controller, MVC) 模式 是 编写 Web 应 用 时 常用 的 模式 ， | 
这 个 模式 是 如 此 的 流行 ， 以 至 于 人 们 有 时 候 会 错误 地 把 这 一 模式 当成 了 Web 应 用 开发 本 身 。 | 


实际 上 ，MVC 模 式 最 初 是 在 20 世 纪 70 年 代 末 的 施乐 帕 罗 奥 多 研究 中 心 (Xerox PARC) | 
被 引入 到 Smalltalk 语 言 里 面 的 ， 这 一 模式 将 程序 分 成 了 模型 、 视 图 和 控制 器 3 个 部 分 ， 其 中 模 
型 用 于 表示 底层 的 数据 ， 而 视图 则 以 可 视 化 的 方式 向 用 户 展示 模型 ， 至 于 控制 器 则 会 根据 用 
户 的 输入 对 模型 进行 修改 。 每 当 模型 发 生变 化 时 ， 视 图 都 会 自动 进行 更 新 ， 从 而 展现 出 模型 
的 最 新 状态 。 | 


尽管 MVC 模 式 起 源 于 桌面 开发 ， 但 它 在 编写 Web 应 用 方面 也 流行 了 起 来 一 一 包括 Ruby | 
on Rails、CodeIgniter、Play 和 Spring MVC 在 内 的 很 多 Web 应 用 框架 都 把 MVC 用 作 它 们 的 基本 | 
模式 。 在 这 些 框架 里 面 ， 模 型 一 般 都 会 通过 结构 (struct) 或 对 象 (object) BRAY (map) 到 数 
据 库 ， 而 视图 则 会 被 渲染 为 HTML， 至 于 控制 器 则 负责 对 请 求 进行 路 由 ， 并 管理 对 模型 的 访 | 
问 e : 


使 用 MVC 框 架 进行 Web 应 用 开发 的 新 手 程序 员 常常 会 误 以 为 MVC 模 式 是 开发 Web 应 用 的 
唯一 方法 ， 但 Web 应 用 本 质 上 只 是 一 个 通过 HTTP 协 议 与 用 户 互动 的 程序 ， 只 要 能 够 实现 这 种 
互动 ， 程 序 本 身 可 以 使 用 任何 一 种 模式 开发 ， 甚 至 不 使 用 模式 也 是 可 以 的 。 


为 了 防止 模型 变 得 过 于 腔 肿 ， 并 且 出 于 代码 复 用 的 需要 ， 开 发 者 
有 时候 会 使 用 服务 对 象 ” (service object) 或 者 函数 (function) 对 模型 
进行 操作 。 尽 管 服务 对 象 严格 来 说 并 不 是 MVC 模 式 的 一 部 分 ， 但 是 通 
过 把 相同 的 逻辑 放置 到 服务 对 象 里 面 ， 并 将 同一 个 服务 对 象 应 用 到 不 
同 的 模型 之 上 ， 可 以 有 效 地 避免 在 多 个 模型 里 面 复制 相同 代码 的 窗 


FE o 


正如 之 前 所 说 ，Web 应 用 并 不 是 一 定 要 用 MVC 模 式 进 行 开 发 一 一 
通过 将 控制 万 和 模型 进行 合并 ， 然 后 由 处 理 瑚 直接 执行 所 有 操作 并 加 
客户 半 返 回 啊 应 的 做 法 不 仅 是 可 行 的 ， 而 且 也 是 十 分 合理 的 。 


1.9.2 ”模板 引擎 


通过 HTTP 响 应 报 文 回 传 给 客户 端的 HTML 是 由 模板 (template) 
转换 而 成 的 ， 模 板 里 面 可 能 会 包含 HTML， 但 也 可 能 不 会 ， 而 模板 引擎 
(template engine) 则 通过 模板 和 数据 来 生成 最 终 的 HTML。 正 如 之 前 
所 说 ， 模 板 引 敬 是 经 由 早期 的 SSI 技 术 演 变 而 来 的 。 


模板 可 以 分 为 静态 模板 和 动态 模板 两 种 ， 这 两 种 模板 都 有 各 目的 


设计 哲学 。 


静态 模板 是 一 些 夹 杂 着 占 位 符 的 HTML ， 静 态 模 板 引 警 通 过 将 静 
态 模板 中 的 占 位 符 玲 换 成 相应 的 数据 来 生成 最 终 的 HTML， 这 种 做 
法 和 SSI 技 术 的 概念 非常 相似 。 因 为 静态 模板 通常 不 包含 任何 逻辑 
代码 ， 又 或 者 只 包含 少量 逻辑 代码 ， 所 以 这 种 模板 也 称 为 无 逻辑 
模板 。CTemplate 和 Mustache 都 属于 静态 模板 引擎 。 

动态 模板 除了 包含 HTML 和 占 位 符 之 外 ， 还 包含 一 些 编程 语言 结 
构 ， 如 条 件 语句 、 和 迭代 语句 和 变量 。JavaServer Pages (JSP) ` 
Active Server Pages (ASP) 和 Embedded Ruby (ERB) 都 属于 动态 
模板 引擎 。PHP 刚 诞生 的 时 候 看 上 去 也 像 是 一 种 动态 模板 ， 它 是 
后 才 逐 渐 演 变 成 一 门 编程 语言 鸣 。 


到 目前 为 止 ， 本 章 已 经 介绍 了 很 多 Web 应 用 背后 的 基础 知识 以 及 原 
理 。 初 看 上 去 ， 这 些 内 容 可 能 会 显得 过 于 琐碎 了 ， 但 随 着 读者 对 本 书 
内 容 的 不 断 深入 ， 理 解 这 些 基础 知识 的 重要 性 就 会 慢 慢 地 显现 出 来 。 
在 了 解 了 Web 应 用 开发 所 需 的 基本 知识 之 后 ， 现 在 是 时 候 进 入 下 一 个 阶 
段 一 一 开始 实际 地 进行 Go 编程 了 。 在 接 下 来 的 一 六， 我 们 将 开始 学 习 
如 何 使 用 Go 开发 Web 应 用 。 


1.10 Hello Go 


在 这 一 节 ， 我 们 将 开始 学 习 如 何 实际 地 使 用 Go 语言 构建 Web 应 
A ere, 根据 附录 中 的 
指示 安装 Go 并 设置 相关 的 环境 变量 。 本 节 在 构建 Web 应 用 时 将 会 用 到 
Go 的 net/http 包 ， 因 为 本 书 将 会 在 接 下 来 的 几 章 中 对 这 个 包 进 行 详 
细 的 介绍 ， 所 以 即使 目前 对 这 个 包 知之 其 少 也 不 必 过 于 担心 。 目 前 
来 说 ， 你 只 需要 在 电脑 上 键入 本 节 展 示 的 代码 ， 编 译 它 ， 然 后 观察 这 
些 代 码 是 如 何 运行 的 就 可 以 了 。 习 惯 了 使 用 大 小 写 无 关 编 程 语言 的 读 
者 请 注意 ， 因 为 Go 语言 是 区 分 大 小 写 的 ， 所 以 在 键入 本 书展 示 的 代码 
时 请 务必 注意 代码 的 大 小 写 。 


本 书展 示 的 所 有 代码 都 可 以 在 这 个 GitHub 页 面 找到 : 
https://github.com/sausheong/gwp ° 


请 在 你 的 工作 空间 的 src 目录 中 创建 一 个 first_webapp FE 
录 ， 并 在 这 个 子 目 录 里 面 创 建 一 个 server .go 文件 ， 然 后 将 代码 清单 
1-1 中 展示 的 源 代码 键入 到 文件 里 面 。 


代码 清单 1-1 使 用 Go 构建 的 Hello World Web 应 用 


package main 


"net/http" 
) 


func handler(writer http.Responsewriter, request *http.Request) { 
fmt.Fprintf (writer, "Hello World, %s!", request.URL.Path[1:]) 


func main() { 
http.HandleFunc("/", handler) 
http.ListenAndServe(":8080", nil) 


在 一 切 就 绪 之 后 ， 请 打开 你 的 终端 ， 执 行 以 下 命令 : 


$ go install first_webapp 


你 可 以 在 任意 目录 中 执行 这 个 命令 。 在 正确 地 设置 了 GOPATH 环境 
变量 的 情况 下 ， 这 个 命令 将 在 你 的 $6G60PATH/bin 目录 中 创建 一 个 名 为 
first webapp 的 二 进 制 可 执行 文件 ， 接 着 就 可 以 在 终端 里 面 运行 这 
个 文件 了 。 如 果 你 按照 附录 的 指示 ， 将 $GOPATH/bin 目录 也 添加 到 了 
PATH 环境 变量 当中 ， 那 么 你 也 可 以 在 任意 目录 中 执行 first_webapp 
文件 。 被 执行 的 first_webapp 文件 将 在 系统 的 8080 端 口上 启动 你 的 
Web 应 用 。 一 切 就 这 么 简单 ! 


现在 ， 打 开 网 页 浏 跑 器 ， 访 问 http:Mlocalhost:8080/。 如 果 一 切 正 
常 ， 那 么 你 将 会 看 到 图 1-3 所 示 的 内 容 。 


AA ae http://localhost:8080/ x Egg 
(€) © localhost:8080 c = 


Hello World, ! 


图 1-3 ”我 们 创建 的 首 个 Web 应 用 


让 我 们 来 仔细 地 分 析 一 下 这 个 Web 应 用 的 代码 。 第 一 行 代码 声明 了 
这 个 程序 所 属 的 包 ， 跟 在 package 关键 字 之 后 的 main 就 是 包 的 名 
字 。Go 语 言 要 求 可 执行 程序 必须 位 于 main 包 当 中 ，Web 应 用 也 不 例 
外 。 如 果 你 曾经 使 用 过 Ruby、Python 或 者 Java 等 其 他 编程 语言 来 开发 
Web 应 用 ， 那 么 你 可 能 已 经 发 现 了 Go 和 这 些 语言 之 间 的 区 别 : 其 他 语 
言 通常 需要 将 Web 应 用 部 署 到 应 用 服务 器 上 面 ， 并 由 应 用 服务 器 为 Web 
应 用 提供 运行 环境 ， 但 是 对 Go 来 说 ，Web 应 用 的 运行 环境 是 由 
net/http 包 直 接 提 供 的 ， 这 个 包 和 应 用 的 源 代 码 会 一 起 被 编译 成 一 


个 可 以 快速 部 署 的 独立 Web 应 用 。 


位 于 package 语句 之 后 的 ijmport 语句 用 于 导入 所 需 的 包 : 


import ( 
"fmt " 


"net/http" 


被 导入 的 包 分 别 为 fmt 包 和 http 包 ， 前 者 使 得 程序 可 以 使 用 
Fprintf 等 国 数 对 IO 进行 格式 化 ， 而 后 者 则 使 得 程序 可 以 与 HTTP 进 
行 交互 。 顺 带 一 提 ，Go 的 ijmport 语句 不 仅 可 以 导入 标准 库 里 面 的 
包 ， 还 可 以 从 第 三 方 库 里 面 导 入 包 。 


出 现在 导入 语句 之 后 的 是 一 个 琅 数 定义 : 


func handler(writer http.Responsewriter, request *http.Request) { 
fmt.Fprintf (writer, "Hello World, %s!", request.URL.Path[1:]) 


} 


这 3 行 代码 定义 了 一 个 名 为 handler 的 函数 。 人 处理 器 ”(handler ) 
这 个 名 字 通 第 用 来 表示 在 指定 事件 被 触发 之 后 ， 人 负责 对 事件 进行 处 理 
的 回调 函数 ， 这 也 正 是 我 们 如 此 命名 这 个 函数 的 原因 (不 过 从 技术 上 
来 说 ， 至 少 在 Go 语言 里 面 ， 这 个 画 数 并 不 是 一 个 处 理 器 ， 而 十 一 个 处 
理 器 函数 ， 处 理 器 和 处 理 器 函数 之 间 的 区 别 将 在 第 3 章 中 介绍 ) 。 


这 个 处 理 器 函数 接受 两 个 参数 作为 输入 ， 第 一 个 参数 为 
Responsewriter 接口 ， 第 二 个 参数 则 为 指向 Request 结构 的 指 
ft > handler 函数 会 从 Request 结构 中 提取 相关 的 信息 ， 人 然后 创建 
一 个 HITP 响 应 ， 最 后 再 通过 Responsewriter 接口 将 响应 返回 给 客 


户 端 。 至 于 handler 函数 内 部 的 Fprintf 函数 在 被 调用 时 则 会 使 用 
一 个 ResponseWwriter 接口 、 一 个 带 有 单个 格式 化 指示 符 ”(%s ) 的 
格式 化 字符 串 以 及 从 Request 结构 里 面 提 取 到 的 路 径 信 息 作 为 参数 。 
因为 我 们 之 前 访问 的 地 址 为 http://localhost:8080/， 所 以 应 用 并 没有 打印 
出 任何 路 径 信息 ， 但 如 果 我 们 访问 地 址 
http://localhost:8080/sausheong/was/here, FANE as IAS Hem HK 1-4 
所 示 的 信息 。 


Go 语言 规定 ， 每 个 需要 被 编译 为 二 进 制 可 执行 文件 的 程序 都 必须 
包含 一 个 main 函数 ， 用 作 程 序 执行 时 的 起 点 : 


func main() { 
http.HandleFunc("/", handler) 


http.ListenAndServe(":8080", nil) 


这 个 main 函数 的 作用 非常 直观 ， 它 百 移 把 之 前 定义 的 handler 
函数 设置 成 根 (root) URL (/) 被 访问 时 的 处 理 器 ， 然 后 启动 服务 器 
并 让 它 监听 系统 的 8080 端 口 〈 按 下 Ctrl+C 可 以 停止 这 个 服务 器 ) 。 至 
此 ， 这 个 使 用 Go 语言 编写 的 Hello World Web 应 用 就 算 顺 利 完成 了 。 


ene | http://localhost...usheong/was/here % \ 二 


| (€) @ localhost:8080/sausheong/was/here Cc 


| Hello World, sausheong/was/here! 


Al1-4 带 有 路 径 信息 的 Hello World 示 例 


本 章 以 介绍 Web 应 用 的 基础 知识 开始 ， 并 最 终 走 马 观 伦 地 编写 了 一 
个 简单 却 没什么 用 处 的 Go Web 应 用 作为 结束 。 在 接 下 来 的 一 章 中 ， 我 
们 将 会 看 到 更 多 代码 ， 并 学 习 如 何 使 用 Go 语言 以 及 它 的 标准 库 去 编写 
更 真实 的 Web 应 用 (不 过 这 些 应 用 距离 真正 生产 级 别 的 应 用 还 有 一 定 距 
A) 。 尽 管 第 2 章 出 现 的 大 量 代码 可 能 会 让 读者 有 一 种 加 加 吞 吉 的 感 
觉 ， 但 我 们 将 会 从 中 学 习 到 一 个 典型 的 Go Web 应 用 是 如 何 组 织 的 。 


1.11 小 结 


。 使 用 Go 开发 的 web 应 用 不 仅 具 有 可 扩展 、 模 块 化 和 可 维护 等 特 
性 ， 而 且 使 用 Go 还 能 够 更 容易 地 开发 出 性 能 更 高 的 应 用 ， 因 此 Go 
是 一 门 非 常 适合 进行 Web 开 发 的 编程 语言 。 

因为 Web 应 用 是 一 种 通过 HTTP 协议 向 客户 端 返回 HTML 的 程序 ， 
所 以 理解 HTTP 协 议 对 学 习 Web 应 用 开发 来 说 是 相当 重要 的 。 
HTTP 是 一 种 简单 、 无 状态 、 纯 文本 的 客户 端 -服务 器 协议 ， 它 用 于 
在 客户 端 和 服务 器 之 间 进 行 数据 交换 。 

HTTP 的 请 求 和 响应 都 以 相同 的 格式 进行 组 织 一 一 它们 首先 以 一 个 
请 求 行 或 者 响应 行 作为 开始 ， 接 着 后 跟 一 个 或 多 个 首部 ， 最 后 还 
有 一 个 可 选 的 主体 。 

每 个 HTTP 请 求 都 有 一 个 请 求 行 ， 请 求 行 里 面包 含 一 个 HITP 方 

法 ，HTTP 方 法 标示 了 请 求 想 要 让 服务 器 执行 的 动作 。GET 方法 和 
POST 方法 是 最 常用 的 两 个 HITP 方 法 。 

每 个 HTTP 响应 都 有 一 个 响应 行 ， 响 应 行 会 告知 客户 端 请 求 的 执行 
状态 。 

任何 Web 应 用 都 包含 处 理 器 和 模板 引擎， 这 两 个 主要 部 分 分 别 与 
HTTP 协 议 的 请 求 和 啊 应 相对 应 。 

处 理 器 负责 接收 HTTP 请 求 并 处 理 它们 。 

模板 引 敬 负责 生成 HTML， 这 些 HTML 之 后 会 作为 HTTP 响 应 的 其 
中 一 部 分 被 回 传 至 客户 端 。 


第 2 章 ChitChatiPtz 


本 章 主要 内 容 


。 使 用 Go 进行 Web 编 程 的 方法 
设计 一 个 典型 的 Go Web 应 用 
编写 一 个 完整 的 Go Web 应 用 
了 解 Go Web 应 用 的 各 个 组 成 部 分 


上 一 章 在 末尾 展示 了 一 个 非常 简单 的 Go Web 应 用 ， 但 是 因为 该 应 
用 只 是 一 个 Hello World 程 序 ， 所 以 它 实 际 上 并 没有 什么 用 处 。 在 本 章 
中 ， 我 们 将 会 构建 一 个 简单 的 网 上 论坛 Web 应 用 ， 这 个 应 用 同样 非常 基 
础 ， 但 是 却 有 用 得 多 : 它 允 许 用 户 登 录 到 论坛 里 面 ， 然 后 在 论坛 上 发 
布 新 帖子 ， 又 或 者 回复 其 他 用 户 发 表 的 帖子 。 


虽然 本 章 介绍 的 内 容 无 法 让 你 一 下 子 台 学 会 如 何 编写 一 个 非常 成 
熟 的 Web 应 用 ， 但 这 些 内 容 将 教会 你 如 何 组 织 和 开发 一 个 Web 应 用 。 在 
阅读 完 这 一 章 之 后 ， 你 将 进一步 地 了 解 到 使 用 Go 进行 Web 应 用 开发 的 
相关 方法 。 


如 有 果 你 觉得 本 章 介绍 的 内 容 难度 较 大 ， 又 或 者 你 觉得 本 章 展示 的 
大 量 代 码 看 起 来 让 人 觉得 胆战心惊 ， 那 也 不 必 过 于 担心 : 本 章 之 后 的 
几 章 将 对 本 章 介 绍 的 内 容 做 进一步 的 解释 ， 在 阅读 完 本 章 并 继续 阅读 
后 续 章 节 时 ， 你 将 会 对 本 章 介绍 的 内 容 有 更 加 深入 的 了 解 。 


2.1 _ChitChat 简 介 


网 上 论坛 无 处 不 在 ， 它 们 是 互联 网 上 最 受 欢 迎 的 应 用 之 一 ， 与 旧 
式 的 电子 公告 栏 (BBS) 、 新 闻 组 (Usenet) 和 电子 邮件 一 脉 相 承 。 鸦 
席 公 司 和 Google 公 司 的 群 组 (Groups) 都 非常 流行 ， 雅 虎 报告 称 ， 他 
们 总 共 拥 有 1000 万 个 群 组 以 及 1.15 亿 个 群 组 成 员 ， 其 中 每 个 群 组 都 拥有 
一 个 目 己 的 论坛 ， 而 全 球 最 具 人 气 的 网 上 论坛 之 一 一 一 Gaia 在 线 一 一 
则 拥有 2300 万 注册 用 户 以 及 接近 230 亿 张 帖子 ， 并 且 这 些 帖 子 的 数量 还 
在 以 每 天 上 百 万 张 的 速度 持续 增长 。 尽 管 现 在 出 现 了 诸如 Facebook 这 
样 的 社交 网 站 ， 但 论坛 仍然 是 人 们 在 网 上 进行 交流 时 最 为 常用 的 手段 
之 一 。 作 为 例子 ， 图 2-1 展 示 了 GoogleGroups 的 样子 。 


eee < få Qroups.google.com/forum/#!forum/golang-nuts e 由 
| 
Google KE -ong 
Groups Cc Mark all as read Filters ~ 2p ~ 从 - 


» golang-nuts Shared publicly 


60 of 20102 topics (99+ unread) * 30 About 


| El Unseriatizing interface types with json (4) 4posts 12:55 
El Extended logic in golang text/templates (2) 2 12:54 

El Problem with custom types using Postgresq! (1) 1 11:45 

Dl How to organize a go project that also includes other languages? (1) 1 11:23 

El How to compile golang functions as a static library or a dynamic to explode to object-c? (2) 2 08:04 

El FireBird connection (2) 2 08:01 

DI Can we call a GO function/library in JAVA code? (4) i 07:49 

El Go in Action vs Programming in Go (5) 5 05:57 

El GPL licensed go software (3) 3 04:34 
Dl Announcing gsoup: an HTML sanitizer (and some questions) (2) 2 04:00 

* El Which web framework is recommended to use with GO? (9) 9 02:05 
Dl beginner : best way to learn go (3) 3 00:45 

t RI (RFC) Watching err with “watch” Expression Block [RFC] (14) 14 17 Jan 
* Fl Go runtime - GOMAXPROCs and threads (4) 4 17 Jan 
El Poor performance reading stdin (40) 40 17 Jan 

t RI time.Parse of two reference times aren't equal (7) 7 17 Jan 
El Capitalization of fields in private structs (16) 16 17 Jan 

El reaching for sync.WaitGroup feels wrong... (24) 24 17 Jan 

* D] How do verify an xmi document containing a signature and X.509 data? (7) 7 17 Jan 
El Go 1.4.1 is released (10) 10 17 Jan 

* D How to read *.xis file using golang (3) 3 17 Jan 


图 2-1 一 个 网 上 论坛 示例 : GoogleGroups 里 面 的 Go 编程 语言 论坛 


从 本 质 上 来 说 ， 网 上 论坛 就 相当 于 一 个 任何 人 都 可 以 通过 发 帖 来 
进行 对 话 的 公告 板 ， 公 告 板 上 面 可 以 包含 已 注册 用 户 以 及 未 注册 的 匿 
名 用 户 。 论 坛 上 的 对 话 称 为 帖子 (thread) ， 一 个 帖子 通常 包含 了 作者 
想 要 讨论 的 一 个 主题 ， 而 其 他 用 户 则 可 以 通过 回复 这 个 帖子 来 参与 对 
话 。 比 较 复 杂 的 论坛 一 般 都 会 按 层 级 进行 划分 ， 在 这 些 论 坛 里 面 ， 可 
能 会 有 多 个 讨论 特定 类 型 主题 的 子 论坛 存在 。 大 多 数论 坛 都 会 由 一 个 
或 多 个 拥有 特殊 权限 的 用 户 进 行 管理 ， 这 些 拥 有 特殊 权限 的 用 户 被 称 
为 版 主 (moderator) 。 


在 本 章 中 ， 我 们 将 会 开发 一 个 名 为 ChitChat 的 简易 网 上 论坛 。 为 了 
让 这 个 例子 保持 简单 ， 我 们 只 会 为 ChitChat 实 现 网 上 论坛 的 关键 特性 : 
在 这 个 论坛 里 面 ， 用 户 可 以 注册 账号 ， 并 在 登录 之 后 发 表 新 帖子 义 或 
着 回 复 已 有 的 帖子 ， 末 注册 用 户 可 以 查看 帖子 ,但 十 无 法 发 表 帖 子 或 
征 回 复 帖子 。 现在， 让 我 们 首先 来 思考 一 下 如 何 设计 ChitChat 这 个 应 
用 。 


[关于 本 章 民 示 的 代码 AE E E NEET EEEE DETO EA E E | 


跟 本 书 的 其 他 章节 不 一 样 ， 因 为 篇 幅 的 关系 ， 本 章 并 不 会 展示 ChitChat 沦 坛 的 所 有 实现 ， 
| 代码， 但 你 可 以 在 GitHub 页 面 https:/github.com/sausheong/gwp 找 到 这 些 代码 。 如 果 你 打算 在 | 
| 阅读 本 章 的 同时 实际 了 解 一 下 这 个 应 用 ， 那 么 这 些 完 整 的 代码 应 该 会 对 你 有 所 帮助 。 


2.2 ”应 用 设计 


正如 第 1 章 所 说 ，Web 应 用 的 一 般 工 作 流程 是 客户 端 向 服务 器 发 送 
请 求 ， 然 后 服务 器 对 客户 端 进行 响应 (如 图 2-2 所 示 ) ，ChitChat 应 用 
的 设计 也 芝 循 这 一 流程 。 


1. 发 送 HTTP 请 求 2. 处 理 HTTP 请 求 


3. 返回 HTTP 响 应 


图 2-2 ”Web 应 用 的 一 般 工作 流程 ， 客 户 端 向 服务 器 发 送 请 求 ， 然 后 等 得 接收 响应 


ChitChat 的 应 用 逻辑 会 被 编码 到 服务 器 里 面 。 服 务 器 会 向 客户 端 提 
供 HIML 页 面 ， 并 通过 页 面 的 超 链接 向 客户 端 表 明 请 求 的 格式 以 及 被 请 
求 的 数据 ， 而 客户 端 则 会 在 发 送 请 求 时 向 服务 器 提供 相应 的 数据 ， 如 
图 2-3 所 示 。 


服务 器 会 通过 HTML 页 面 上 的 超 链 
接 ， 向 Web 应 用 表明 请 求 的 格式 。 


http://<servername>/<handlername>?<parameters> 


请 求 
客户 端 服务 器 
响应 


图 2-3 HTTP 请 求 的 URL 格 式 


请 求 的 格式 通 单 是 由 应 用 目 行 决定 的 ， 比 如 ，ChitChat 的 请 求 使 用 
的 是 以 下 格式 http://< 服 务 如 名 >< 处 理事 名 >?< 参 数 > 。 


服务 器 名 (server name) 是 ChitChat 服 务 器 的 名 字 ， 而 处 理 器 名 
(handler name) 则 是 被 调用 的 处 理 器 的 名 字 。 处 理 器 的 名 字 是 按 层级 
进行 划分 的 : 位 于 名 字 最 开头 是 被 调用 模块 的 名 字 ， 而 之 后 跟着 的 则 
是 被 调用 子 模块 的 和 名字， 以 此 类 推 ， 位 于 处 理 堪 名 字 最 末尾 的 则 是 子 
模块 中 负责 处 理 请 求 的 处 理 器 。 比 如 ， 对 /thread/read 这 个 处 理 右 
BPR, thread 是 被 调用 的 模块 ， 而 read 则 是 这 个 模块 中 负责 读 
取 帖 子 内 容 的 处 理 器 。 


该 应 用 的 参数 (parameter) 会 以 URL 查 询 的 形式 传递 给 处 理 器 ， 
而 处 理 需 则 会 根据 这 些 参数 对 请 求 进行 处 理 。 比 如 说 ， 假 设 客户 端 要 
向 处 理 器 传递 帖子 的 唯一 ID， 那 么 它 可 以 将 UREL 的 参数 部 分 设置 成 
id=123 ， 其 中 123 就 是 帖子 的 唯一 JID。 


如 果 chitchat 就 是 ChitChat 服 务 如 的 名 字 ， 那 么 根据 上 面 介绍 的 
URL 格 式 规则 ， 客 户 端 发 送 给 ChitChat 服 务 器 的 URL 可 能 会 是 这 样 的 : 
http://chitchat/thread/read?id=123 ° 


当 请 求 到 达 服 务 器 时 ， 多 路 复 用 器 (multiplexer) 会 对 请 求 进 行 检 
碍 ， 并 将 请 求 重 定向 至 正确 的 处 理 器 进行 处 理 。 处 理 器 在 接收 到 多 路 
复 用 需 转 发 的 请 求 之 后 ， 会 从 请 求 中 取出 相应 的 信息 ， 并 根据 这 些 信 
奶 对 请 求 进行 处 理 。 在 请 求 处 理 完毕 之 后 ， 处 理 器 会 将 所 得 的 数据 传 
递 给 模板 引擎， 而 模板 引擎 则 会 根据 这 些 数据 生成 将 要 返回 给 客户 端 
的 HIML ， 整 个 过 程 如 图 2-4 所 示 。 


多 路 复 用 器 会 对 URL 请 求 
进行 检查 ， 并 将 它 重 定向 
至 正确 的 处 理 器 。 


一 一 一 一 一 一 一 一 一 并 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 、 


赤 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 由 


处 理 器 会 向 模板 


ea 引擎 提供 数据 。 


一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


图 2-4 服务 器 在 典型 Web 应 用 中 的 工作 流程 


2.3 ”数据 模型 


a a 
它 的 数据 将 被 存储 到 关系 式 数 据 库 PostgreSQL 里 面 ， 并 通过 SQL 与 之 区 
Fa 
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是 : 
。 User 表示 论坛 的 用 户 信息 ; 
。 Session 表示 论坛 用 户 当 前 的 登录 会 话 ; 


。 Thread 一 一 表示 论坛 里 面 的 帖子 ， 每 一 个 帖子 都 记录 了 多 个 论坛 用 
户 之 间 的 对 话 ; 
表示 用 户 在 帖子 里 面 添加 的 回复 。 


e Post. 
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4 种 数据 结构 是 如 何 与 数据 库 交 互 的 。 


ChitChat 论 坛 介 许 用 户 在 登录 之 后 发 布 新 帖子 或 者 回复 已 有 的 帖 
子 ， 未 登录 的 用 户 可 以 阅读 帖子 ， 但 是 不 能 发 布 新 帖子 或 者 回复 帖 
子 。 为 了 对 应 用 进行 简化 ，ChitChat 论 坛 没 有 设置 版 主 这 一 职位 ， 因 此 


用 户 在 发 布 新 帖子 或 者 添加 新 回复 的 时 候 不 需要 经 过 审核 。 


图 2-5 ”Web 应 用 访问 数据 存储 系统 的 流程 


在 了 解 了 ChitChat 的 设计 方案 之 后 ， 现 在 可 以 开始 考虑 具体 的 实现 
代码 了 。 在 开始 学 习 ChitChat 的 实现 代码 之 前 ， 请 注意 ， 如 果 你 在 阅读 


本 章 展示 的 代码 时 遇 到 困难 ， 又 或 者 你 是 刚 开 始 学 习 Go 语 言 ， 那 么 为 
了 更 好 地 理解 本 章 介 绍 的 内 容 ， 你 可 以 考虑 移 伦 些 时 间 阅 读 一 本 Go 语 
言 的 编程 入 门 书 ， 比 如 ， 由 William Kennedy ` Brian Ketelsen 和 Erik St. 
Martin 撰 写 的 《Go 语言 实战 》 殉 是 一 个 很 不 错 的 选择 。 


除 此 之 外 ， 在 阅读 本 章 时 也 请 尽量 保持 耐性 : 本 章 只 是 从 宏观 的 
角度 展示 Go Web 应 用 的 样子 ， 并 没有 对 Web 应 用 的 细 市 作 过 多 的 解 
释 ， 而 是 将 这 些 细节 留 到 之 后 的 章节 再 进一步 说 明 。 在 有 需要 的 情况 
下 ， 本 章 也 会 在 介绍 某 种 技术 的 同时 ， 说 明 在 哪 一 章 可 以 找到 这 一 技 
术 的 更 多 相关 信息 。 


2.4 ”请 求 的 接收 与 处 理 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 正 如 之 前 所 说 ，Web 应 
用 的 工作 流程 如 下 。 


(1) 客户 端 将 请 求 发 送 到 服务 器 的 一 个 URL 上 。 


(2) 服务 器 的 多 路 复 用 器 将 接收 到 的 请 求 重 定向 到 正确 的 处 理 
ae, PRS Sh Ba A KITA o 
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(3) 处 理 器 处 理 请 求 并 执行 必要 的 动作 。 


(4) 处 理 器 调用 模板 引擎， 生成 相应 的 HTML 并 将 其 返回 给 客户 


端 。 


让 我 们 先 从 最 基本 的 根 URL (/ ) 来 考虑 Web 应 用 是 如 何 处 理 请 求 
， 当 我 们 在 浏览 器 上 输入 地 址 http://localhost 的 时 候 ， 浏 览 器 
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ChitChat 是 如 何 处 理发 送 至 根 UREL 的 请 求 的 ， 以 及 它 又 是 如 何 通过 动态 
地 生成 HTML 来 对 请 求 进 行 响应 的 。 


2.4.1 多 路 复 用 器 
因为 编译 后 的 二 进 制 Go 应 用 总 是 以 main 函数 作为 执行 的 起 点 ， 所 
以 我 们 在 对 Go 应 用 进行 介绍 的 时 候 也 总 是 从 包含 main 函数 的 主 源 码 文 


件 (main source code file) 开始 。ChitChat 应 用 的 主 源 码 文件 为 
main .go ， 代 码 清单 2-1 展 示 了 它 的 一 个 简化 版 本 。 


代码 清单 2-1 main.go 文件 中 的 main 函数 ， 画 数 中 的 代码 经 过 了 简化 


package main 

import ( 
"net/http" 

func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir("/public") ) 


mux.Handle("/static/", http.StripPrefix("/static/", files) ) 


mux.HandleFunc("/", index) 


server := &http.Server{ 
Addr: "0.0.0.0:8080", 
Handler: mux, 


server .ListenAndServe( ) 


} 


main.go 中 首先 创建 了 一 个 多 路 复 用 器 ， 然 后 通过 一 些 代码 将 接 
收 到 的 请 求 重 定向 到 处 理 器 。net/http 标准 库 提 供 了 一 个 默认 的 多 


BE Alas, ANSE Han Diol al FB NewServeMux 函数 来 创建 : 


mux := http.NewServeMux( ) 


为 了 将 发 送 至 根 URL 的 请 求 重 定 癌 到 处 理 器 ， 程 序 使 用 了 
HandleFunc 函数 : 


mux.HandleFunc("/", index) 


HandleFunc 郴 数 接受 一 个 URL 和 一 个 处 理 器 的 名 字 作为 参数 ， 
并 将 针对 给 定 URL 的 请 求 转 发 至 指定 的 处 理 器 进行 处 理 ， 因 此 对 上 壕 
调用 来 说 ， 当 有 针对 根 URL 的 请 求 到 达 时 ， 该 请 求 就 会 被 重 定 癌 到 名 
为 index 的 处 理 器 函数 。 此 外 ， 因 为 所 有 处 理 器 都 接受 一 个 
Responsewriter 和 一 个 指向 Request 结构 的 指针 作为 参数 ， 并 且 
所 有 请 求 参 数 都 可 以 通过 访问 Request 结构 得 到 ， 所 以 程序 并 不 需要 
向 处 理 器 显 式 地 传 入 任何 请 求 参 数 。 


需要 注意 的 是 ， 前 面 的 介绍 模糊 了 处 理 器 以 及 处 理 器 函数 之 间 的 
区 别 : 我 们 刚 开 始 谈论 的 是 处 理 器 ， 而 现在 谈论 的 却 是 处 理 器 函数 。 
这 是 有 意 而 为 之 的 一 一 尽管 处 理 器 和 处 理 器 函数 提供 的 最 终结 果 是 
样 的 ， 但 它们 实际 上 并 不 相同 。 本 书 的 第 3 董 将 对 处 理 器 和 处 理 右 函数 
之 间 的 区 别 做 进一步 的 说 明 ， 但 是 现在 让 我 们 暂时 先 忘 掉 这 件 事 ， 继 
续 人 研究 ChitChat 应 用 的 代码 实现 。 


2.4.2 ”服务 静态 文件 


除 负责 将 请 求 重 定向 到 相应 的 处 理 器 之 外 ， 多 路 复 用 器 还 需要 为 
静态 文件 提供 服务 。 为 了 做 到 这 一 点 ， 程 序 使 用 FileServer 函数 创 
建 了 一 个 能 够 为 指定 目 孙 中 的 静态 文件 服务 的 处 理 器 ， 并 将 这 个 处 理 
器 传递 给 了 多 路 复 用 器 的 Handle 画 数 。 除 此 之 外 ， 程 序 还 使 用 
StripPrefix 函数 去 移 除 请 求 URL 中 的 指定 前 级: 


files := http.FileServer(http.Dir("/public") ) 


mux.Handle("/static/", http.StripPrefix("/static/", files)) 


当 服 务 器 接收 到 一 个 以 /static/ 开头 的 URL 请 求 时 ， 以 上 两 行 
代码 会 移 除 URL 中 的 /static/ 字符 串 ， 然 后 在 public 目录 中 查找 
被 请 求 的 文件 。 比 如 说 ， 当 服务 右 接 收 到 一 个 针对 文件 
http://localhost/static/css/bootstrap.min.css 的 请 求 
时 ， 它 将 会 在 public 目录 中 查找 以 下 文件 : 


<application root>/css/bootstrap.min.css 


当 服 务 右 成 功 地 找到 这 个 文件 之 后 ， 


2.4.3 ”创建 处 理 器 函数 


会 把 它 返 回 给 客户 端 。 


正如 之 前 的 小 市 所 说 ，ChitChat 应 用 会 通过 HandleFunc 函数 把 请 
求 重 定向 到 处 理 器 函数 。 正 如 代码 清单 2-2 所 示 ， 处 理 器 函数 实际 上 职 
是 一 个 接受 Responsewriter 和 Request 指针 作为 参数 的 Go 函数 。 


代码 清单 


2-2 main.go 文 件 9 


PF 的 jndex 处 理 器 函数 


func index(w http.Responsewriter, r *http.Request) { 
files := []string{"templates/layout.html", 
"templates/navbar.html", 
"templates/index.htm1", } 
templates := template.Must(template.ParseFiles(files...)) 


threads, err := data.Threads(); if err == nil { 
templates.ExecuteTemplate(w, "layout", threads) 


index 函数 负责 生成 HTIML 并 将 其 写 入 Responsewriter 中 。 
为 这 个 处 理 器 函数 会 用 到 html/template 标准 库 中 的 Template 结 
构 ， 所 以 包含 这 个 函数 的 文件 需要 在 文件 的 开头 导入 
html/template 库 。 之 后 的 小 节 将 对 生成 HTML 的 方法 做 进一步 的 介 


绍 。 


除了 前 面 提 到 过 的 a 处 理 根 URL 请 求 的 jndex 处 理 器 函数 ， 
main. go 文件 实际 上 还 包含 很 多 其 他 的 处 理 需 函 数 ， 如 代码 清单 2-3 所 
不 o 


代码 清单 2-3 ”ChitChat 应 用 的 main. go 源 文件 


package main 


import ( 
"net/http" 
) 


func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir(config.Static) ) 
mux.Handle("/static/", http.StripPrefix("/static/", files) ) 


mux.HandleFunc("/", index) 
mux.HandleFunc("/err", err) 


mux.HandleFunc("/login", login) 
mux.HandleFunc("/logout", logout) 
mux.HandleFunc("/signup", signup) 
mux.HandleFunc("/signup_account", signupAccount ) 
mux.HandleFunc("/authenticate", authenticate) 


mux .HandleFunc("/thread/new", newThread) 
mux.HandleFunc("/thread/create", createThread) 
mux.HandleFunc("/thread/post", postThread) 
mux.HandleFunc("/thread/read", readThread) 


server := &http.Server{ 
Addr: "0.0.0.0:8080", 
Handler: mux, 


} 


server .ListenAndServe( ) 


main 函数 中 使 用 的 这 些 处 理 器 函数 并 没有 在 main , go 文件 中 定 


义 ， 它 们 的 定义 在 其 他 文件 里 面 ， 具 体 请 参考 ChitChat 项 目的 完整 源 
码 。 


为 了 在 一 个 文件 里 面 引用 男 一 个 文件 中 定义 的 函数 ， 诸 如 PHP、 
Ruby 和 Python 这 样 的 语言 要 求 用 户 编写 代码 去 包含 (include) 被 引用 
函数 所 在 的 文件 ， 而 另 一 些 语 言 则 要 求 用 户 在 编译 程序 时 使 用 特殊 的 
链接 (link) 命令 。 


但 是 对 Go 语言 来 说 ， 用 户 只 需要 把 位 于 相同 目录 下 的 所 有 文件 都 
设置 成 同一 个 包 ， 那 么 这 些 文件 就 会 与 包 中 的 其 他 文件 分 享 彼此 的 定 
义 。 又 或 者 ， 用 户 也 可 以 把 文件 放 到 其 他 独立 的 包 里面 ， 然 后 通过 导 
A (import) 这 些 包 来 使 用 它们 。 比 如 ，ChitChat 论 坛 束 把 连接 数据 库 
的 代码 放 到 了 独立 的 包 里 面 ， 我 们 很 快 就 会 看 到 这 一 点 。 


2.4.4 ”使 用 cookie 进 行 访问 控制 


跟 其 他 很 多 Web 应 用 一 样 ，ChitChat 既 拥有 任何 人 都 可 以 访问 的 公 
开 页 面 ， 也 拥有 用 户 在 登录 账号 之 后 才能 看 见 的 私人 页 面 。 


当 一 个 用 户 成 功 登 录 以 后 ， 服 务 器 必须 在 后 续 的 请 求 中 标示 出 这 
是 一 个 已 登录 的 用 户 。 为 了 做 到 这 一 点 ， 服 务 右 会 在 响应 的 首部 中 写 
入 一 个 cookie， 而 客户 端 在 接收 这 个 cookie 之 后 则 会 把 它 存储 到 浏览 器 
里 面 。 代 码 清单 2-4 展 示 了 authenticate 处 理 器 函数 的 实现 代码 ， 这 
个 函数 定义 在 route_auth ,go 文件 中 ， 它 的 作用 就 是 对 用 户 的 身份 
进行 验证 ， 并 在 验证 成 功 之 后 向 客户 端 返 回 一 个 cookie。 


代码 清单 2-4 route_auth.go 文件 中 的 authenticate 处 理 器 函数 


func authenticate(w http.Responsewriter, r *http.Request) { 
r.ParseForm() 
user, _ := data.UserByEmail(r.PostFormValue("email") ) 
if user.Password == data.Encrypt(r.PostFormValue("password")) { 
session := user.CreateSession() 
cookie := http.Cookie{ 
Name: " cookie", 
Value: session.Uuid, 
HttpOnly: true, 


http.SetCookie(w, &cookie) 
http.Redirect(w, r, "/", 302) 
} else { 
http.Redirect(w, r, "/login", 302) 
} 


} 


注意 ， 代 码 清单 2-4 中 的 authenticate 函数 使 用 了 两 个 我 们 尚未 
介绍 过 的 函数 ， 一 个 是 data,Encrypt ， 而 另 一 个 则 是 
data.UserbyEmail 。 因 为 本 节 关 注 的 是 ChitChat 论 坛 的 访问 控制 机 
制 而 不 是 数据 处 理 方法 ， 所 以 本 市 将 不 会 对 这 两 个 画 数 的 实现 细 市 进 


行 解 释 ， 但 这 两 个 函数 的 名 字 已 经 很 好 地 说 明了 它们 各 自 的 作用 : 
data.UserByEmail 函数 通过 给 定 的 电子 邮件 地 址 获取 与 之 对 应 的 
User 结构 ， 而 data.Encrypt 函数 则 用 于 加 密 给 定 的 字符 串 。 本 章 
稍 后 将 会 对 data 包 作 更 详细 的 介绍 ， 但 是 在 此 之 前 ， 让 我 们 回 到 对 访 
问 控制 机 制 的 讨论 上 来 。 


在 验证 用 户 身 份 的 时 候 ， 程 序 必须 先 确保 用 户 是 真实 存在 的 ， 并 
且 提 交 给 处 理 器 的 密码 在 加 密 之 后 跟 存 储 在 数据 库 里 面 的 已 加 密 用 户 
密码 完全 一 致 。 在 核实 了 用 户 的 身份 之 后 ， 程 序 会 使 用 User 结构 的 
CreateSession 方法 创建 一 个 Session 结构 ， 该 结构 的 定义 如 下 : 


type Session struct { 
I £ 


Uuid 

Email 

UserId 

CreatedAt time.Time 


Session 结构 中 的 Email 字段 用 于 存储 用 户 的 电子 邮件 地 址 ， 而 
UserId 字段 则 用 于 记录 用 户 表 中 存储 用 户 信息 的 行 的 D。Uuid 字段 
存储 的 是 一 个 随机 生成 的 唯一 ID， 这 个 ID 是 实现 会 话机 制 的 核心 ， 服 
务 器 会 通过 cookie 把 这 个 ID 存储 到 浏览 器 里 面 ， 并 把 Session 结构 中 
记录 的 各 项 信息 存储 到 数据 库 中 。 


在 创建 了 Session 结构 之 后 ， 程 序 又 创建 了 cookie 结构 : 


cookie := http.Cookie{ 
Name: " cookie", 
Value: session.Uuid, 


HttpOnly: true, 
} 


cookie 的 名 字 是 随意 设置 的 ， 而 cookie 的 值 则 是 将 要 被 存储 到 浏览 
器 里 面 的 唯一 ID。 因 为 程序 没有 给 cookie 设 置 过 期 时 间 ， 所 以 这 个 
cookie 就 成 了 一 个 会 话 cookie， 它 将 在 浏览 娇 关闭 时 目 动 被 移 除 。 此 
外 ， 程 序 将 Httponly 字段 的 值 设置 成 了 true ， 这 意味 着 这 个 cookie 
只 能 通过 HTTP 或 者 HTTPS 访 问 ， 但 是 却 无 法 通过 JavaScript 等 非 HTTP 
API 进 行 访问 。 


在 设置 好 cookie 之 后 ， 程 序 使 用 以 下 这 行 代码 ， 将 它 添加 到 了 响应 
的 首部 里 面 : 


http.SetCookie(writer, &cookie) 


在 将 cookie 存 储 到 浏览 器 里 面 之 后 ， 程 序 接 下 来 要 做 的 就 是 在 处 理 
回 函 数 里 面 检查 当前 访问 的 用 户 是 否 已 经 登录 。 为 此 ， 我 们 需要 创建 
一 个 名 为 session 的 工具 (utility) WAL, FER Sa ee ES 
用 它 。 代 码 清单 2-5 展 示 了 session 函数 的 实现 代码 ， 跟 其 他 工具 函数 
一 样 ， 这 个 函数 也 是 在 uti1l .go 文件 里 面 定义 的 。 再 提醒 一 下 ， 虽 然 
程序 把 工具 函数 的 定义 都 放 在 了 util.go 文件 里 面 ， 但 是 因为 
util.go 文件 也 隶属 于 main 包 ， 所 以 这 个 文件 里 面 定义 的 所 有 工具 
函数 都 可 以 直接 在 整个 main 包 里 面 调用 ， 而 不 必 像 data.Encrypt 
函数 那样 需要 允 引 入 包 然 后 再 调用 。 


代码 清单 2-5 util.go 文件 中 的 session 工具 函数 


func session(w http.Responsewriter, r *http.Request)(sess 
data.Session, err 
error){ 
cookie, err := r.Cookie(" cookie") 
if err == nil { 
sess = data.Session{Uuid: cookie.Value} 


if ok, _ := sess.Check(); !ok { 
err = errors.New("Invalid session") 
} 
} 


return 


为 了 从 请 求 中 取出 cookie，session ERATE AR T LA FRIS: 


cookie, err := r.Cookie(" cookie") 


如 果 cookie 不 存在 ， 那 么 很 明显 用 户 并 未 登录 ; 相反 ， 如 果 cookie 
存在 ， 那 么 session Ë J 卖 进行 第 二 项 检查 一 一 访问 数据 库 并 核 


am 否 存 在 。 第 二 项 检查 是 通过 data.Session KAE 
成 的 ， 这 Ta 话 并 调用 后 者 的 Check 方法 : 


sess = data.Session{Uuid: cookie.Value} 
if ok, _ := sess.Check(); !ok { 


} 


err = errors.New("Invalid session") 


在 拥有 了 检查 和 识别 已 登录 用 户 和 未 登录 用 户 的 能 力 之 后 ， 让 我 
们 来 回顾 一 下 之 前 展示 的 ijndex 处 理 器 函数 ， 代 码 清 单 2-6 中 被 加 粗 的 
AST EAN SIX Sb as BBE Ul A session 函数 的 。 


代码 清单 2-6 index 处 理 器 函数 


func index(w http.Responsewriter, r *http.Request) { 
threads, err := data.Threads(); if err == nil { 
, err := session(w, r) 


public tmpl files := []string{"templates/layout.html", 
"templates/public.navbar.html", 
"templates/index.html") 
private tmpl files := []string{"templates/layout.html", 
"templates/private.navbar.html", 
"templates/index.html") 
var templates *template.Template 
if err != nil { 
templates = template.Must(template.Parse- 
Files(private_tmpl_files...)) 
} else { 
templates = 
template.Must(template.ParseFiles(public_tmpl_files...)) 
} 
templates.ExecuteTemplate(w, "layout", threads) 
} 
} 


通过 调用 session 函数 可 以 取得 一 个 存储 了 用 户 信息 的 Session 
结构 ， 不 过 因为 index 函数 目前 并 不 需要 这 些 信 息 ， 所 以 它 使 用 空 日 
标识 符 (blank identifier) (_) 忽略 了 这 一 结构 。index KHAA ER 
兴趣 的 是 err 变量 ， 程 序 会 根据 这 个 变量 的 值 来 判断 用 户 是 否 已 经 登 
录 ， 然 后 以 此 来 选择 是 使 用 public 导航 条 还 是 使 用 private 导航 


条 。 


好 的 ， 关 于 ChitChat 应 用 处 理 请 求 的 方法 就 介绍 到 这 里 了 。 本 章 接 
下 来 会 继续 讨论 如 何 为 客户 端 生 成 HIML， 并 完整 地 叙述 之 前 没有 说 完 


的 部 分 。 


2.5 ”使 用 模板 生成 HTML 响应 


index 处 理 珍 函数 里 面 的 大 部 分 代码 都 站 用 来 为 客户 端 生成 
HTML 的 。 首 移 ， 函 数 把 每 个 需要 用 到 的 模板 文件 都 放 到 了 Go 切片 里 
面 (这 里 展示 的 是 私有 页 面 的 模板 文件 ， 公 开 页 面 的 模板 文件 也 是 以 
同样 方式 进行 组 织 的 ) : 


private tmpl files := []string{"templates/layout.html", 


"templates/private.navbar.html", 
"templates/index.html") 


跟 Mustache 和 CTemplate 等 其 他 模板 引擎 一 样 ， 切 厂 指 定 的 这 3 个 
HTML 文 件 都 包含 了 特定 的 散 入 命令 ， 这 些 命令 被 称 为 动作 
(action) ， 动 作 在 HTML 文 件 里 面 会 被 {{ 符号 和 }} 符号 包围 。 


接着 ， 程 序 会 调用 parseFiles 函数 对 这 些 模板 文件 进行 语法 分 
析 ， 并 创建 出 相应 的 模板 。 i le hee 
误 ， 程 序 使 用 了 Must 函数 去 包围 ParseFiles 函数 的 执行 结果 ， 

样 当 parseFiles 返回 错误 的 时 候 ，Must 函数 就 会 向 用 户 返 
的 错误 报告 : 


templates := 


template.Must(template.ParseFiles(private_tmpl_files...)) 


好 的 ， 关 于 模板 文件 的 介绍 已 经 足够 多 了 ， 现 在 是 时 候 来 看 看 它 
们 的 庐山 真面目 了 。 


ChitChat 论 坛 的 每 个 模板 文件 都 定义 了 一 个 模板 ， 这 种 做 法 并 不 是 
强制 的 ， 用 户 也 可 以 在 一 个 模板 文件 里 面 定义 多 个 模板 ， 但 模板 文件 
和 模板 一 一 对 应 的 做 法 可 以 给 开发 带 来 方便 ， 我 们 在 之 后 就 会 看 到 这 
一 点 。 代 码 清 单 2-7 展 示 了 layout ,html 模板 文件 的 源 代码 ， 源 代码 
中 使 用 了 define 动作 ， 这 个 动作 通过 文件 开头 的 {{ define 
"layout" }} 和 文件 末尾 的 {{ end }} ， 把 被 包围 的 文本 块 定义 成 
了 layout 模板 的 一 部 分 ° 


代码 清单 2-7 layout .html 模板 文件 


{{ define "layout" }} 


<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=9"> 


<meta name="viewport" content="width=device-width, initial- 
scale=1"> 


<title>ChitChat</title> 
<link href="/static/css/bootstrap.min.css" rel="stylesheet"> 


<link href="/static/css/font-awesome.min.css" rel="stylesheet"> 
</head> 


<body> 
{{ template "navbar" . }} 
<div class="container"> 


{{ template "content" . }} 


</div> <!-- /container --> 


<script src="/static/js/jquery-2.1.1.min.js"></script> 
<script src="/static/js/bootstrap.min.js"></script> 
</body> 
</html> 


{{ end }} 


除了 define 动作 之 外 ，layout ,html 模板 文件 里 面 还 包含 了 两 
个 用 于 引用 其 他 模板 文件 的 template 动作 。 跟 在 被 引用 模板 名 字 之 
后 的 点 〈, ) 代表 了 传递 给 被 引用 模板 的 数据 ， 比 如 {{ template 
"navbar" . }} 语句 除了 会 在 语句 出 现 的 位 置 引 入 navbar 模板 之 
外 ， 还 会 将 传递 给 layout 模板 的 数据 传递 给 navbar 模板 。 


代码 清单 2-8 展 示 了 pub1lic.navbar .html 模板 文件 中 的 
navbar 模板 ， 除 了 定义 模板 自身 的 define 动作 之 外 ， 这 个 模板 没有 
包含 其 他 动作 (严格 来 说 ， 模 板 也 可 以 不 包含 任何 动作 ) 。 


代码 清单 2-8 ”public .navbar .html 模板 文件 


{{ define "navbar" }} 


<div class="navbar navbar-default navbar-static-top" 
role="navigation"> 
<div class="container"> 
<div class="navbar-header"> 
<button type="button" class="navbar-toggle collapsed" 
= data-toggle="collapse" data-target=".navbar-collapse"> 
<span class="sr-only">Toggle navigation</span> 
<span class="icon-bar"></span> 
<span class="icon-bar"></span> 
<span class="icon-bar"></span> 
</button> 
<a Class="navbar-brand" href="/"> 
<i class="fa fa-comments-o"></i> 
ChitChat 
</a> 
</div> 
<div class="navbar-collapse collapse"> 
<ul class="nav navbar-nav"> 
<li><a href="/">Home</a></1i> 
</ul> 
<ul class="nav navbar-nav navbar -right"> 
<li><a href="/login">Login</a></1i> 
</ul> 
</div> 


</div> 
</div> 


{{ end }} 


最 后 ， 让 我 们 来 看 看 定义 在 index .html 模板 文件 中 的 content 
模板 ， 代 码 清单 2-9 展 示 了 这 个 模板 的 源 代 码 。 注 意 ， 尽 管 之 前 展示 的 
两 个 模板 都 与 模板 文件 拥有 相同 的 名 字 ， 但 实际 上 模板 和 模板 文件 分 
别 拥有 不 同 的 名 字 也 是 可 行 的 。 


代码 清单 2-9 index.html 模板 文件 


{{ define "content" }} 


<p class="lead"> 
<a href="/thread/new">Start a thread</a> or join one below! 
</p> 


{{ range . }} 
<div class="panel panel-default"> 
<div class="panel-heading"> 
<span class="lead"> <i class="fa fa-comment-o"></i> {{ .Topic 
}}</span> 
</div> 
<div class="panel-body"> 
Started by ff .User.Name }} - {{ .CreatedAtDate }} - {{ 
.NumReplies }} 
posts. 
<div class="pull-right"> 
<a href="/thread/read?id={{.Uuid }}">Read more</a> 
</div> 
</div> 
</div> 


{{ end }} 
{{ end }} 


index.html 文件 里 面 的 代码 非常 有 趣 ， 特 别 值 得 一 提 的 是 文件 
里 面包 含 了 几 个 以 点 号 〈, ) 开头 的 动作 ， 比 如 {{ .User .Name }} 


和 {{ .CreatedAtDate }} ， 这 些 动作 的 作用 和 之 前 展示 过 的 
index 处 理 器 函数 有 关 : 


threads, err := data.Threads(); if err == nil { 


templates.ExecuteTemplate(writer, "layout", threads) 


在 以 下 这 行 代 码 中 : 
templates.ExecuteTemplate(writer, "layout", threads) 


程序 通过 调用 ExecuteTemplate 函数 ， 执 行 (execute) 已 经 经 
过 语法 分 析 的 layout 模板 。 执 行 模板 意味 着 把 模板 文件 中 的 内 容 和 来 
目 其 他 渠道 的 数据 进行 合并 ， 然 后 生成 最 终 的 HTML 内 容 ， 具 体 过 程 如 
图 2-6 所 示 。 


模板 


图 2-6 ”模板 引擎 通过 合并 数据 和 模板 来 生成 HTML 


程序 之 所 以 对 layout 模板 而 不 是 navbar 模板 或 者 content 模 
板 进行 处 理 ， 是 因为 layout 模板 已 经 引用 了 其 他 两 个 模板 ， 所 以 执行 
layout 模板 就 会 导致 其 他 两 个 模板 也 被 执行 ， 由 此 产生 出 预期 的 
HTML 。 但 是 ， 如 果 程 序 只 执行 havbar 模板 或 者 content 模板 ， 那 
么 程序 最 终 只 会 产生 出 预期 的 HTML 的 一 部 分 。 


现在 ， 你 应 该 已 经 明白 了 ， 点 号 (C) 代表 的 就 是 传 入 到 模板 里 面 
的 数据 (实际 上 还 不 仅 如 此 ， 接 下 来 的 小 节 会 对 这 方面 做 进一步 的 说 
HY) 。 图 2-7 展 示 了 程序 根据 模板 生成 的 ChitChat 论 坛 的 样子 。 


eco < localhost 


Œ ChitChat 


© How long does it take to write a book? 


© What does it take to write a forum application? 


图 2-7 ChitChat Web 应 用 示例 的 主页 


整理 代码 


因为 生成 HTML 的 代码 会 被 重复 执行 很 多 次 ， 所 以 我 们 决定 对 这 些 
代码 进行 一 些 整 理 ， 并 将 它们 移 到 代码 清单 2-10 所 示 的 
generateHTML 函数 里 面 。 


代码 清单 2-10 generateHTML 函数 


func generateHTML(w http.Responsewriter, data interface{}, fn 
.…. String) { 
var files []string 
for , file := range fn 
files = append(files, fmt.Sprintf("templates/%s.html", file) ) 


} 
templates := template.Must(template.ParseFiles(files...)) 
templates.ExecuteTemplate(writer, "layout", data) 


generateHTML 函数 接受 一 个 ResponseWriter 、 一 些 数据 以 
及 一 系列 模板 文件 作为 参数 ， 然 后 对 给 定 的 模板 文件 进行 语法 分 析 。 
data 参数 的 类 型 为 空 接口 类 型 (empty interface type) ， 这 意味 着 该 参 
数 可 以 接受 任何 类 型 的 值 作 为 输入 。 刚 开始 接触 Go 语言 的 人 可 能 会 觉 


得 琳 怪 一 一 Go 不 十 静态 编程 语言 鸣 ， 它 为 什么 能 够 使 用 没有 类 型 限制 
的 参数 ? 


但 实际 上 ，Go 程 序 可 以 通过 接口 (interface) 机 制 ， 巧 妙 地 绕 过 静 
仿 编 程 语言 的 限制 ， 并 厌 此 获得 接受 多 种 不 同类 型 输入 的 能 力 。Go 语 
言 中 的 接口 由 一 系列 方法 构成 ， 并 且 每 个 接口 就 是 一 种 类 型 。 一 个 空 
接口 束 古 一 个 空 集 合 ， 这 意味 着 任何 类 型 都 可 以 成 为 一 个 空 接口 ， 也 
器 古 说 任何 类 型 的 值 都 可 以 传递 给 函数 作为 参数 。 


generateHTML WAN NAANA (...) FA, 它 
表示 generateHTML 函数 是 一 个 可 变 参数 函数 (variadic function) , 
这 意味 着 这 个 函数 可 以 在 最 后 的 可 变 参 数 中 接受 零 个 或 任意 多 个 值 作 
为 参数 。generateHTML 画 数 对 可 变 参数 的 支持 使 我 们 可 以 同时 将 任 
意 多 个 模板 文件 传递 给 该 画 数 。 在 Go 语言 里 面 ， 可 变 参数 必须 是 可 变 
参数 函数 的 最 后 一 个 参数 。 


在 实现 了 generateHTML 函数 之 后 ， 让 我 们 回 过 头 来 ， 继 续 对 
index 处 理 器 函数 进行 整理 。 代 码 清单 2-11 展 示 了 经 过 整理 之 后 的 
index 处 理 器 函数 ， 现 在 它 看 上 去 更 整 河 了 。 


代码 清单 2-11 index 处 理 器 函数 的 最 终 版 本 


func index(writer http.ResponseWriter, request ”http.Request) { 
threads, err := data.Threads(); if err == nil { 
_, err := session(writer, request) 
if err != nil { 
generateHTML(writer, threads, "layout", "public.navbar", 
"index" ) 


} else { 
generateHTML(writer, threads, "layout", "private.navbar", 
"index" ) 
} 
} 


} 


在 这 一 万 中， 我们 学 习 了 很 多 关于 模板 的 基础 知识 ， 之 后 的 第 5 章 
将 对 模板 做 更 详细 的 介绍 。 但 是 在 此 之 前 ， 让 我 们 先 来 了 解 一 下 
ChitChat 必 用 使 用 的 数据 源 (datasource) ， 并 娠 此 了 解 一 下 ChitChatRy 
用 的 数据 是 如 何 与 模板 一 同 生成 最 终 的 HIML 的 。 


2.6 ”安装 PostgreSQL 


在 本 章 以 及 后 续 几 章 中 ， 每 当 遇 到 需要 访问 关系 数据 库 的 场景 ， 
我 们 都 会 使 用 PostgreSQL。 在 开始 使 用 PostgreSQL 之 前 ， 我 们 首先 需要 
学 习 的 是 如 何 安装 并 运行 PostgreSQL， 以 及 如 何 创建 本 章 所 需 的 数据 
库 o 


2.6.1 ”在 Linux 或 FreeBSD 系统 上 安装 


www.postgresql.org/download 为 各 种 不 同 版 本 的 Linux 和 FreeBSD 都 
提供 了 预 编 译 的 二 进 制 安装 包 ， 用 户 只 需要 下 载 其 中 一 个 安装 包 ， 然 
后 根据 指示 进行 安装 就 可 以 了 。 比 如 说 ， 通 过 执行 以 下 命令 ， 我 们 可 
以 在 Ubuntu 发 行 版 上 安装 Postgres: 


sudo apt-get install postgresql postgresql-contrib 


JE 


安装 postgres 包 之 外 ， 还 会 安装 附加 的 工具 
后 启动 PostgreSQL 数 据 库 系 统 。 


这 条 命令 除了 会 
包 ， 并 在 安装 完毕 之 

在 默认 情况 下 ，Postgres 会 创建 一 个 名 为 postgres 的 用 户 ， 并 将 
其 用 于 连接 服务 器 。 为 了 操作 方便 ， 你 也 可 以 使 用 自己 的 名 字 创 建 一 
个 Postgres 账 号 。 要 做 到 这 一 点 ， 首 先 需 要 登入 Postgres 账 号 : 


sudo su postgres 


接着 使 用 createuser 命令 创建 一 个 PostgreSQL 账 号 : 


createuser -interactive 


最 后 ， 还 需要 使 用 createdb 命令 创建 以 你 的 账号 名 字 命 名 的 数 


createdb <YOUR ACCOUNT NAME> 


mi 
| 


2.6.2 ”在 Mac OS X 系 统 上 安装 


要 在 Mac OS X 上 安装 PostgreSQL， 最 简单 的 方法 是 使 用 
PostgresApp.com 提 供 的 Postgres 应 用 : 你 只 需要 把 网 站 上 提供 的 zip 压 缩 
包 下 载 下 来 ， 解 压 它 ， 然 后 把 Postgres .app Xiii Kal 8 AY 
Applications 文件 来 里 面 就 可 以 了 。 启 动 Postgres.app 的 方法 
跟 启 动 其 他 Mac OS X 应 用 的 方法 完全 一 样 。Postgres.app 在 初次 启 
动 的 时 候 会 初始 化 一 个 新 的 数据 库 集 群 ， 并 为 自己 创建 一 个 数据 库 。 
因为 命令 行 工具 psql 也 包含 在 了 Postgres.app 里 面 ， 所 以 在 设置 
好 正确 的 路 径 之 后 ， 你 就 可 以 使 用 psq1 访问 数据 库 了 。 设 置 路 径 的 工 
作 可 以 通过 在 你 的 ~/ .profile 文件 或 者 ~/ .bashrc 文件 中 添加 以 

下 代码 行 来 完成 是: 


export 
PATH=$PATH: /Applications/Postgres.app/Contents/Versions/9.4/bin 


2.6.3 ”在 Windows 系 统 上 安装 


H Windows AA EAR £ PostgreSQL 图形 安装 程序 都 会 把 一 切 安 
装 步骤 布置 妥当， 用户 只 需要 进行 相应 的 设置 就 可 以 了 ， 所 以 在 
Windows 系 统 上 安装 PostgreSQL 也 是 非常 从 单 和 直观 的 。 其 中 一 个 流行 
的 安装 程序 是 由 Enterprise DB 提供 的 : www.enterprisedb.com/products- 


services-training/pgdownload ° 


除了 PostgreSQL 数 据 库 本 身 之 外 ， 安 闭 包 还 会 附带 诸如 pgAdmin 等 
工具 ， 以 便 用 户 通过 这 些 工 具 进行 后 续 的 配置 。 


2.7 ERAGE 


本 章 前 面 在 展示 ChitChat 应 用 的 设计 方案 时 ， 曾 经 提 到 过 ChitChat 
应 用 包含 了 4 种 数据 结构 。 虽 然 把 这 4 种 数据 结构 放 到 主 源码 文件 里 面 
也 是 可 以 的 ， 但 更 好 的 办 法 是 把 所 有 与 数据 相关 的 代码 都 放 到 另 一 个 
包 里 面 一 一 ChitChat 应 用 的 data 包 也 因此 应 运 而 生 。 


为 了 创建 data 包 ， 我 们 首先 需要 创建 一 个 名 为 data 的 子 目 录 ， 
并 创建 一 个 用 于 保存 所 有 帖子 相关 代码 的 thread ,go 文件 (在 之 后 的 
小 节 里 面 ， 我 们 还 会 创建 一 个 用 于 保存 所 有 用 户 相 关 代码 的 user .go 
文件 ) 。 在 此 之 后 ， 每 当 程序 需要 用 到 data 包 的 时 候 (比如 处 理 器 需 
要 访问 数据 库 的 时 候 ) ， 程 序 都 需要 通过 import 语句 导入 这 个 包 : 


import ( 
"github.com/sausheong/gwp/Chapter_2_Go_ChitChat/chitchat/data" 


代码 清单 2-12 展 示 了 定义 在 thread .go 文件 里 面 的 Thread 24 
构 ， 这 个 结构 存储 了 与 帖子 有 天 的 各 种 信息 。 


mao 


代码 清单 2-12 ”定义 在 thread .go 文件 里 面 的 Thread 结构 


package data 


import( 
"time" 


) 
type Thread struct { 
Id int 


Uuid 

Topic 

UserId 

CreatedAt time.Time 


正如 代码 清单 2-12 中 加 粗 显 示 的 代码 行 所 示 ， 文 件 的 包 名 现在 是 
data 而 不 再 是 main 了 ， 这 个 包 就 是 前 面 小 节 中 我 们 曾经 见 到 过 的 
data 包 。data 包 除 了 包含 与 数据 库 交 互 的 结构 和 代码 ， 还 包含 了 一 
些 与 数据 处 理 密 切 相 关 的 函数 。 隶 属于 其 他 包 的 程序 在 引用 data 包 中 
定义 的 函数 、 结 构 或 者 其 他 东西 时 ， 必 须 在 被 引用 元 素 的 名 字 前 面 显 
式 地 加 上 data 这 个 包 名 。 比 如 说 ， 引 用 Thread 结构 就 需要 使 用 
data.Thread 这 个 名 字 ， 而 不 能 仅仅 使 用 Thread 这 个 名 字 。 


Thread 结构 应 该 与 创建 关系 数据 库 表 threads 时 使 用 的 数据 定 
义 语言 (Data Definition Language, DDL) 保持 一 致 。 因 为 threads 
表 目 前 尚未 存在 ， 所 以 我 们 必须 创建 这 个 表 以 及 容纳 该 表 的 数据 库 。 
创建 chitchat 数据 库 的 工作 可 以 通过 执行 以 下 命令 来 完成 : 


createdb chitchat 


在 创建 数据 库 之 后 ， 我 们 就 可 以 通过 代码 清单 2-13 展 示 的 
setup ,sql 文件 为 ChitChat 论 坛 创 建 相 应 的 数据 库 表 了 。 


TH 


代码 清单 2-13 ”用 于 在 PostgreSQL E 


看 创建 数据 库 表 的 setup. sql 文件 


create table users ( 
id serial primary key, 
uuid varchar(64) not null unique, 
name varchar (255), 
email varchar(255) not null unique, 
password varchar(255) not null, 
created_at timestamp not null 


) ; 


create table sessions ( 
id serial primary key, 
uuid varchar(64) not null unique, 
email varchar(255), 
user_id integer references users(id), 
created_at timestamp not null 


) ; 


create table threads ( 
id serial primary key, 
uuid varchar(64) not null unique, 
topic text, 
user_id integer references users(id), 
created_at timestamp not null 


) ; 


create table posts ( 
id serial primary key, 
uuid varchar(64) not null unique, 
body text, 
user_id integer references users(id), 
thread_id integer references threads(id), 
created_at timestamp not null 


运行 这 个 脚本 需要 用 到 psql 工具 ， 正 如 上 一 节 所 说 ， 工具 通 
常会 随 着 PostgreSQL 一 同安 装 ， 所 以 你 只 需要 在 终 es 
令 就 可 以 了 : 


psql -f setup.sql -d chitchat 


如 果 一 切 正常 ， 那 么 以 上 命令 将 在 chitchat 数据 库 中 创建 出 相 
应 的 表 。 在 拥有 了 表 之 后 ， 程 序 就 必须 考虑 如 何 与 数据 库 进 行 连接 以 
fe ee aA 为 此 ， 程 序 创建 了 一 个 名 为 Db 的 全 局 变量 
全 局 变量 是 一 个 指针 ， 指 向 的 是 代表 数据 库 连 接 池 的 sq1.,DB , 而 
本 Pa 这 个 Db 变量 来 执行 数据 库 查 询 操作 。 代 码 清单 2- 
14 展 示 了 Db 变量 在 data .go 文件 中 的 定义 ， 此 外 还 展示 了 一 个 用 于 
在 Web 应 用 启动 时 对 Db 变量 进行 初始 化 的 jnit 函数 。 


代码 清单 2-14 data.go 文件 中 的 Db 全 局 变量 以 及 init 函数 


Var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "dbname=chitchat sslmode=disable") 


if err != nil { 
log.Fatal(err) 


return 


现在 程序 已 经 拥有 了 结构 、 表 以 及 一 个 指向 数据 库 连 接 池 的 指 
针 ， 接 下 来 要 考虑 的 是 如 何 连接 (connect) Thread 结构 和 threads 
表 。 幸 运 的 是 ， 要 做 到 这 一 点 并 不 困难 : 跟 ChitChat 应 用 的 其 他 部 分 一 


样 ， 我 们 只 需要 创建 能 够 在 结构 和 数据 库 之 间 互 动 的 函数 就 可 以 了 。 
例如 ， 为 了 从 数据 库 里 面 取出 所 有 帖子 并 将 其 返回 给 index Mh FH as EK 
数 ， 我 们 可 以 使 用 thread ,go 文件 中 定义 的 Threads KAk, RBS 
单 2-15 给 出 了 这 个 函数 的 定义 。 


代码 清单 2-15 threads .go 文件 中 定义 的 Threads HA 


func Threads() (threads []Thread, err error){ 
rows, err := Db.Query("SELECT id, uuid, topic, user_id, 
created_at FROM 
threads ORDER BY created_at DESC") 
if err != nil { 
return 


for rows.Next() { 
th := Thread{} 
if err = rows.Scan(&th.Id, &th.Uuid, &th.Topic, &th.UserId, 
=&th.CreatedAt); err != nil { 
return 


} 
threads = append(threads, th) 


rows.Close() 
return 


} 


简单 来 讲 ，Threads 函数 执行 了 以 下 工作 : 


(1) 通过 数据 库 连 接 池 与 数据 库 进行 连接 ; 


(2) 向 数据 库 发 送 一 个 SQL 查 询 ， 这 个 查询 将 返回 一 个 或 多 个 行 
作为 结 来 ; 


(3) 遍历 行 ， 为 每 个 行 分 别 创 建 一 个 Thread 结构 ， 首 先 使 用 这 
个 结构 去 存储 行 中 记录 的 帖子 数据 ， 然 后 将 存储 了 帖子 数据 的 Thread 


结构 追加 到 传 入 的 threads 切片 里 面 ; 


(4) 重复 执行 步骤 3， 直 到 查询 返回 的 所 有 行 都 被 志 历 完毕 为 
eee 


本 书 的 第 6 章 将 对 数据 库 操 作 的 细节 做 进一步 的 介绍 。 


在 了 解 了 如 何 将 数据 库 表 存储 的 帖子 数据 提取 到 Thread 结构 里 面 
之 后 ， 我 们 接 下 来 要 考虑 的 就 古 如 何在 模板 里 面 展 示 Thread 结构 存储 
的 数据 了 。 在 代码 清单 2-9 中 展示 的 index.html 模 板 文 件 ， 有 这 样 一 段 代 
AS: 


{{ range . }} 
<div class="panel panel-default"> 
<div class="panel-heading"> 
<span class="lead"> <i class="fa fa-comment-o"></i> {{ .Topic 


<div class="panel-body"> 
Started by {{ .User.Name }} - {{ .CreatedAtDate }} - {{ 
.NumReplies }} 
posts. 
<div class="pull-right"> 
<a href="/thread/read?id={{.Uuid }}">Read more</a> 
</div> 
</div> 
</div> 


{{ end }} 


正如 之 前 所 说 ， 模 板 动作 中 的 点 号 (.) 代表 传 入 模板 的 数据 ， 它 
们 会 和 模板 一 起 生成 最 终 的 结果 ， 而 {{ range . p 中 的 , 号 代表 
的 是 程序 在 稍 早 之 前 通过 Threads 函数 取得 的 threads 变量 ， 也 就 
是 一 个 由 Thread 结构 组 成 的 切片 。 


range 动作 假设 传 入 的 数据 要 么 是 一 个 由 结构 组 成 的 切片 ， 要 么 
是 一 个 由 结构 组 成 的 数组 ， 这 个 动作 会 般 历 传 入 的 每 个 结构 ， 而 用 户 
则 可 以 通过 字段 名 访问 结构 里 面 的 字段 ， 比 如 ， 动 作 {{ ,Topic }} 
访问 的 是 Thread 结构 的 Topic 字段 。 注 意 ， 在 访问 字段 时 必须 在 字 
段 名 的 前 面 加 上 点 号 ， 并 且 字 段 名 的 首 字 母 必 须 大 写 。 


用 户 除 可 以 在 字段 名 的 前 面 加 上 点 号 来 访问 结构 中 的 字段 以 外 ， 
还 可 以 通过 相同 的 方法 调用 一 种 名 为 方法 (method) 的 特殊 函数 。 比 
如 ， 在 上 面 展示 的 代码 中 ,，{{ .User.Name }} > {{ 
.CreatedAtDate }} 和 {{ .NumReplies }} 这 些 动作 的 作用 就 
是 调用 结构 中 的 同名 方法 ， 而 不 是 访问 结构 中 的 字段 。 


方法 是 隶属 于 特定 类 型 的 函数 ， 指 针 、 接 口 以 及 包括 结构 在 内 的 
所 有 具名 类 型 都 可 以 拥有 目 己 的 方法 。 比 如 说 ， 通 过 将 函数 与 指 回 
Thread 结构 的 指针 进行 绑 定 ， 可 以 创建 出 一 个 针对 Thread 结构 的 方 
法 ， 而 传 入 方法 里 面 的 Thread 结构 则 称 为 接收 者 (receiver) : 方法 
可 以 访问 接收 者 ， 也 可 以 修改 接收 着。 


作为 例子 ， 代 码 清单 2-16 展 示 了 NumReplies 方法 的 实现 代码 。 


代码 清单 2-16 thread ,go 文件 中 的 NumReplies 方法 


func (thread *Thread) NumReplies() (count int) { 
rows, err := Db.Query("SELECT count(*) FROM posts where thread_id 
二 $1", 
thread. Id) 
if err != nil { 
return 


for rows.Next() { 
if err = rows.Scan(&count); err != nil { 


return 


} 


rows.Close() 
return 


NumReplies 方法 首先 打开 一 个 指 癌 数据 库 的 连接 ， 接 着 通过 执 


行 一 条 SQL 查 询 来 取得 帖子 的 数量 ， 并 使 用 传 入 方法 里 面 的 count 参 
数 来 记录 这 个 值 。 最 后 ，NumReplies 方法 返回 帖子 的 数量 作为 方法 
的 执行 结果 ， 而 模板 引 警 则 使 用 这 个 值 去 代替 模板 文件 中 出 现 的 {{ 
.NumReplies }} 动作 。 


通过 为 User ` Session ` Thread 和 Post 这 4 种 数据 结构 创建 
相应 的 函数 和 方法 ，ChitChat 最 终 在 处 理 器 函数 和 数据 库 之 间 构 建 起 了 
一 个 数据 层 ， 以 此 来 避免 处 理 器 函数 直接 对 数据 库 进行 访问 ， 图 2-8 展 
示 了 这 个 数据 层 和 数据 库 以 及 处 理 器 函数 之 间 的 关系 。 虽 然 有 很 多 库 
都 可 以 达到 同样 的 效果 ， 但 亲自 构建 数据 层 能 够 帮助 我 们 学 习 如 何 对 
数据 库 进 行 基本 的 访问 ， 并 厌 此 了 解 到 实现 这 种 访问 并 不 困难 ， 只 需 
要 用 到 一 些 简 单 直 接 的 代码 ， 这 一 点 是 非常 有 益 的 。 


图 2-8 ”通过 结构 模型 连接 数据 库 和 处 理 器 
2.8 ADRAR 


在 本 章 的 最 后 ， 让 我 们 来 看 一 下 ChitChat 应 用 是 如 何 启动 服务 器 并 
将 多 路 复 用 器 与 服务 器 进行 绑 定 的 。 执 行 这 一 工作 的 代码 是 在 
main. go 文件 里 面 定义 的 : 
server := &http.Server{ 


Addr: "0.0.0.0:8080", 
Handler: mux, 


server .ListenAndServe( ) 


这 段 代 码 非常 简单 ， 它 所 做 的 就 是 创建 一 个 Server 结构 ， 然 后 在 
这 个 结构 上 调用 ListenAndServe 方法 ， 这 样 服务 器 就 能 够 启动 了 。 


现在 ， 我 们 可 以 通过 执行 以 下 命令 来 编译 并 运行 ChitChat 应 用 : 


go build 


这 个 命令 会 在 当前 目录 以 及 $GOPATH/bin 目录 中 创建 一 个 名 为 
chitchat 的 二 进 制 可 执行 文件 ， 它 束 是 ChitChat 应 用 的 服务 器 。 接 
看 ， 我 们 可 以 通过 执行 以 下 命令 来 局 动 这 个 服务 郁 : 


如 果 你 已 经 按照 之 前 所 说 的 方法 ， 在 数据 库 里 面 创建 了 ChitChatj 
用 所 需 的 数据 库 表 ， 那 么 现在 你 只 需要 访问 http:/localhost:8080/ 并 注册 
一 个 新 账号 ， 然 后 就 可 以 使 用 自己 的 账号 在 论坛 上 发 布 新 帖子 了 。 


2.9 Web 应 用 运作 流程 回顾 


在 本 章 的 各 市 中 ， 我 们 对 一 个 Go web 应 用 的 不 同 组 成 部 分 进行 了 
初步 的 了 解 和 观察 。 图 2-9 对 鳌 个 应 用 的 工作 流程 进行 了 介绍 ， 其 中 包 
P: 


(1) 客户 端 向 服务 器 发 送 请 求 ; 
(2) 多 路 复 用 器 接收 到 请 求 ， 并 将 其 重 定向 到 正确 的 处 理 器 


(3) 处 理 器 对 请 求 进 行 处 理 ; 


(4) 在 需要 访问 数据 库 的 情况 下 ， 处 理 器 会 使 用 一 个 或 多 个 数据 
结构 ， 这 些 数据 结构 都 是 根据 数据 库 中 的 数据 建 模 而 来 的 ; 


(5) 当 处 理 器 调用 与 数据 结构 有 关 的 函数 或 者 方法 时 ， 这 些 数据 
结构 背后 的 模型 会 与 数据 库 进行 连接 ， 并 执行 相应 的 操作 ; 


(6) 当 请 求 处 理 完毕 时 ， 处 理 器 会 调用 模板 引擎 ， 有 时候 还 会 所 
模板 引擎 传递 一 些 通过 模型 获取 到 的 数据 ; 


(7) 模板 引擎 会 对 模板 文件 进行 语法 分 析 并 创建 相应 的 模板 ， 而 
这 些 模板 义 会 与 处 理 如 传递 的 数据 一 起 合并 生成 最 终 的 HTML; 


(8) 生成 的 HTML 会 作为 响应 的 一 部 分 回 传 至 客户 端 。 


图 2-9 Web 应 用 工作 流程 概 响 


主要 的 步骤 大 概 就 是 这 些 。 在 接 下 来 的 几 章 中 ， 我 们 会 更 加 深入 
地 学 习 这 一 工作 流程 ， 并 进一步 了 解 该 流程 涉及 的 各 个 组 件 。 


2.10 小结 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 

多 路 复 用 器 会 将 HTTP 请 求 重 定向 到 正确 的 处 理 器 进行 处 理 ， 针 对 
静态 文件 的 请 求 也 是 如 此 。 

处 理 器 函数 是 一 种 接受 Responsewriter 和 Requeest 指针 作 
为 参数 的 Go 函数 。 

cookie 可 以 用 作 一 种 访问 控制 机 制 。 

对 模板 文件 以 及 数据 进行 语法 分 析 会 产生 相应 的 HTML， 这 些 
HTML 会 被 用 作 返 回 给 浏览 器 的 响应 数据 。 

通过 使 用 sql 包 以 及 相应 的 SQL 语句 ， 用 户 可 以 将 数据 持久 地 存 
储 在 关系 数据 库 中 。 


[1] 在 安装 Postgres .app 时， 你 可 能 需要 根据 Postgres ,app 的 版 
本 对 路 径 的 版 本 部 分 做 相应 的 修改 ， 比 如 ， 将 其 中 的 9 .4 修改 为 9.5 
或 者 9.6 ， 诸 如 此 类 。 一 一 译 者 注 


第 二 部 分 “Web 应 用 的 基本 组 成 部 分 


所 有 Web 应 用 都 遵循 一 个 简单 的 请 求 与 啊 应 编程 模型 ， 客 户 端 发 
送 的 每 个 请 求 都 会 接收 到 一 个 来 目 服 务 器 的 啊 应 。 每 个 Web 应 用 都 会 
包含 几 个 基本 组 件 ， 其 中 路 由 器 人 负责 将 请 求 转发 至 不 同 的 处 理 絮 ， 处 
理 亏 负责 对 请 求 进行 处 理 ， 而 模板 引擎 则 会 根据 静态 文件 和 动态 数据 
生成 返回 给 客户 端的 数据 。 


在 接 下 来 的 第 3 章 到 第 6 章 ， 我 们 将 学 习 如 何在 Go 语言 里 面 使 用 路 
由 器 去 接收 HTTP 请 求 ， 如 何 使 用 处 理 器 去 处 理 请 求 ， 以 及 如 何 使 用 模 
板 引擎 去 创建 啊 应 数据 。 因 为 大 部 分 Web 应 用 都 会 以 茶 种 方式 存储 数 
据 ， 所 以 我 们 还 会 学 习 如 何 使 用 Go 语言 对 数据 进行 持久 化 。 


第 3 章 ”接收 请 求 


本 章 主要 内 容 


。 Go 语言 的 net/http 标准 库 的 使 用 方法 
。 通过 net/http 库 提 供 HITP 服 务 的 方法 
。 关于 处 理 器 以 及 处 理 器 函数 的 更 详细 信息 
。 在 服务 器 上 使 用 多 路 复 用 器 的 方法 


在 第 2 革 中 ， 我 们 看 到 了 一 个 简单 的 网 上 论坛 Web 应 用 是 由 什么 组 
件 构成 的 ， 也 了 解 到 了 这 些 组 件 是 如 何 组 织 成 一 个 Go Web 应 用 的 。 虽 
然 我 们 已 经 对 构成 Go Web 应 用 的 各 个 组 件 有 了 基本 的 了 解 ， 但 关于 这 
些 组 件 还 有 很 多 值得 深入 的 事情 。 在 接 下 来 的 几 章 里 ， 我 们 将 更 为 深 
入 地 了 解 这 些 组 件 的 细节 ， 并 详细 地 探讨 这 些 组 件 是 如 何 组 合 起 来 
OR 


本 对 和 下 一 章 将 对 Web 应 用 的 “大 脑 ”( 也 就 是 负责 接收 和 人 处理 客 户 
端 请 求 的 处 理 器 ) 进行 讨论 。 在 本 章 中 ， 我 们 将 要 学 习 的 是 如 何 使 用 
Go 语言 去 创建 一 个 Web 服 务 器 ， 以 及 如 何 处 理 客户 闻 发 送 的 请 求 。 


3.1 ”Go 的 net/http 标 准 库 
在 进行 Web 应 用 开发 的 时 候 ， 使 用 成 熟 并 且 复 杂 的 Web 应 用 框架 通 


常会 使 开发 变 得 更 加 迅速 和 简便 ， 但 这 也 意味 着 开发 者 必须 接受 框架 
目 喘 的 一 到 约 定 和 模式 。 虽 然 很 多 框架 都 认为 目 己 提供 的 约定 和 模式 


是 最 佳 实践 (best practice) ， 但 是 如 果 开 发 者 没有 正确 地 理解 这 些 最 
让 实践， 那么 对 最 佳 实践 的 应 用 就 可 能 会 发 展 为 货物 崇拜 编程 (cargo 
cult programming) : 开发 者 如 果 不 了 解 这 些 约定 和 模式 的 用 法 ， 就 可 
能 会 在 不 必要 甚至 有 害 的 情况 下 盲目 地 使 用 它们 。 


BE (ititi‘i<_u | 


第 二 次 世界 大 战 期 间 ， 盟 军 为 了 对 战事 提供 支援 ， 在 太平 洋 的 多 个 岛屿 上 设立 了 空军 基 
地 ， 以 空投 的 方式 向 部 队 以 及 支援 部 队 的 岛 民 投 送 了 大 量 生活 用 品 以 及 军事 设备 ， 从 而 极 大 
地 改善 了 部 队 以 及 岛 民 的 生活 ， 岛 民 也 因此 第 一 次 看 到 了 人 工 生产 的 衣物 、 镀 头 食品 以 及 其 
也 物品 。 在 战争 结束 之 后 ， 这 些 空军 基地 便 被 废弃 了 ， 货 物 空投 自然 也 停止 了 。 此 时 ， 岛 民 
数 了 一 件 非常 符合 其 本 性 的 事情 一 一 他 们 把 自己 打扮 成 空 管 员 、 士 兵 以 及 水 手 ， 使 用 机 场 上 
的 指挥 棒 挥 舞 着 着 陆 信号 ， 进 行 地 面 阅兵 演习 ， 试 图 让 飞机 继续 空投 货物 ， 货 物 崇拜 一 词 也 
因此 而 诞生 。 | 


尽管 货物 崇拜 程序 员 并 没有 像 岛 民 一 样 挥舞 指挥 棒 ， 但 他 们 却 大 量 地 复制 和 粘贴 从 
stackOverflow 这 类 网 站 上 找 来 的 代码 ， 这 些 代码 虽然 能 够 运行 ， 但 是 他 们 却 对 这 些 代码 的 工 
作 原 理 一 点 也 不 了 解 。 这 样 做 的 结果 是 ， 他 们 通常 无 法 扩展 和 修改 这 些 代码 。 与 此 类 似 ， 货 
物 崇 拜 程序 员 通 常会 在 既 不 了 解 框架 为 什么 使 用 特定 的 模式 或 约定 ， 也 不 知道 框架 做 了 何 种 
取舍 的 情况 下 ， 言 目地 使 用 Web 框 架 。 


举 个 例子 来 说 ， 因 为 HTTP 是 一 种 无 连接 协议 (connection-less 
protocol) ， 通 过 这 种 协议 发 送 给 服务 器 的 请 求 对 服务 器 之 前 处 理 过 的 
请 求 一 无 所 知 ， 所 以 应 用 程序 才 会 以 cookie 的 方式 在 客户 端 实现 数据 持 
久 化 ， 并 以 会 话 的 方式 在 服务 器 上 实现 数据 持久 化 ， 而 不 了 解 这 一 点 
的 人 是 很 难 理解 为 什么 要 在 不 同 连接 之 间 使 用 cookie 和 会 话 实现 信息 持 
久 化 的 。 为 了 降低 使 用 cookie 和 会 话 市 来 的 复杂 性 ，Web 应 用 框架 通常 
都 会 提供 一 个 统一 的 接口 (uniform interface) ， 用 于 在 连接 之 间 实 现 
持久 化 。 这 样 做 的 结果 是 ， 很 多 新 手 程序 员 都 会 想当然 地 假设 在 连接 
之 间 进 行 持 久 化 唯一 要 做 的 束 古 使 用 框架 提供 的 接口 。 但 是 由 于 这 类 


接口 通常 都 是 根据 框架 自身 的 习惯 制定 的 ， 因 此 不 同 框架 提供 的 接口 
可 能 会 有 所 不 同 。 更 糟 料 的 古 ， 不 同 的 框架 可 能 会 提供 一 些 名 子 相同 
的 接口 ， 但 是 这 些 同名 接口 之 间 的 实现 却 久 千差万别、 各 不 相同 ， 
此 给 开发 者 这 来 不 必要 的 困惑 。 通 过 这 个 例 了 于 可 以 看 出 ， 使 用 框架 进 
行 Web 应 用 开发 意味 着 将 框架 与 应 用 进行 绑 定 ， 之 后 无 论 是 将 应 用 迁移 
至 男 一 个 框架 ， 还 是 对 应 用 进行 扩展 ， 叉 或 者 为 应 用 添加 新 的 特性 ， 
都 需要 对 框架 本 身 有 深入 的 了 解 ， 在 某 些 情况 下 可 能 还 需要 对 框架 进 
行 定制 。 


本 书 的 目的 并 不 是 让 大 家 抛弃 框架 、 约 定 和 模式 一 一 一 个 好 的 框 
架 通 常 是 快速 构建 可 扩展 且 健 壮 的 Web 应 用 的 最 好 方法 ， 但 理解 那些 隐 
藏 在 框架 之 下 的 底层 概念 和 基础 设施 也 是 非常 重要 的 。 只 要 对 框架 的 
实现 原理 有 了 正确 的 认识 ， 我 们 束 可 以 更 加 清晰 地 了 解 到 这 些 约定 和 
模式 是 如 何 形 成 的 ， 从 而 避免 陷阱 、 理 清 思 路 ， 不 再 盲目 地 使 用 模 
ee 


对 Go 语言 来 说 ， 隐 藏 在 框架 之 下 的 通常 是 net/http 和 
html/template 这 两 个 标准 库 ， 本 章 和 接 下 来 的 第 4 章 将 介绍 
net/http 库 ， 而 之 后 的 第 5 章 将 介绍 htmlLVtemplate 库 。 


如 图 3-1 所 示 ，net/httop 标准 库 可 以 分 为 客户 端 和 服务 器 两 个 间 
分 ， 库 中 的 结构 和 函数 有 些 只 支持 客户 端 和 服务 器 这 两 者 中 的 一 个 ， 
而 有 些 则 同时 支持 客户 端 和 服务 器 : 


e Client > Response > Header > Request fl Cookie 对 客户 
ing 进行 文 持 ; 


e Server »ServeMux »Handler/HandleFunc ` 
Responsewriter > Header ` Request 和 Cookie 则 对 服务 
ay 进行 文 持 。 


本 章 接 下 来 将 会 展示 如 何 把 net/http 标准 库 用 作 服 务 器 以 及 如 
何 使 用 Go 语言 接收 客户 端 发 送 的 HTTP 请 求 。 在 之 后 的 第 4 章 ， 我 们 还 
会 继续 使 用 net/http 标准 库 ， 但 焦点 会 放 在 如 何 处 理 请 求 上 面 。 


在 本 书 中 ， 我 们 主要 关注 的 是 如 何 使 用 netVhttp 标准 库 的 服务 
圳 功能 而 非 客户 端 功能 。 


服务 器 


ResponseWriter 


Request 


Cookie 


Response Server 


ServeMux 


图 3-1 net/http 标准 库 的 各 个 组 成 部 分 


3.2 ”使 用 Go 构建 服务 器 


如 图 3-2 所 示 ， 通 过 net/http 标准 库 ， 我 们 可 以 启动 一 个 HTTP 服 
务 器 ， 然 后 让 这 个 服务 器 接收 请 求 并 向 请 求 返 回 啊 应 。 除 此 之 外 ， 
net/http 标准 库 还 提供 了 一 个 连接 多 路 复 用 器 (multiplexer) 的 接口 
以 及 一 个 默认 的 多 路 复 用 器 。 


图 3-2 ”通过 Go 服务 器 处 理 请 求 


3.2.1 Go Web 服 务 器 


跟 其 他 编程 语言 里 面 的 绝 大 多 数 标准 库 不 一 样 ，Go 提 供 了 一 系列 
用 于 创建 Web 服 务 器 的 标准 库 。 正 如 代码 清单 3-1 所 示 ， 创 建 一 个 服务 
器 的 步骤 非常 简单 ， 只 要 调用 ListenAndServe 并 传 入 网 络 地 址 以 及 
负责 处 理 请 求 的 处 理 器 (handler) 作为 参数 就 可 以 了 。 如 果 网 络 地 址 
数 为 空 字符 串 ， 那 么 服务 器 默认 使 用 80 端 口 进 行 网 络 连接 ， 如 果 处 
器 参数 为 ni1 ， 那 么 服务 器 将 使 用 默认 的 多 路 复 用 器 


DefaultServeMux ° 


is W 


代码 请 单 3-1 最 简单 的 Web 服 务 器 


package main 


import ( 
"net/http" 
) 


func main() { 


http.ListenAndServe("", nil) 
} 


用 户 除 了 可 以 通过 ListenAndServe 的 参数 对 服务 器 的 网 络 地 址 
和 处 理 需 进行 配置 之 外 ， 还 可 以 通过 Server 结构 对 服务 器 进行 更 详细 
的 配置 ， 其 中 包括 为 请 求 读 取 操作 设置 超时 时 间 、 on 写 入 操作 设 
置 超时 时 间 以 及 为 Server 结构 设置 错误 日 志 记录 器 


RT eects pene 基本 上 是 相同 的 ， 它 们 之 间 的 唯 
一 区 别 在 于 代码 清单 3-2 可 以 通过 Server 结构 对 服务 器 进行 更 多 的 配 
5B 


代码 清单 3-2” 带 有 附加 配置 的 Web 服 务 器 


package main 


import ( 
"net/http" 
) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: nil, 


server .ListenAndServe( ) 


} 


代码 清单 3-3 展 示 了 Server 结构 所 有 可 选 的 配置 选 


代码 清单 3-3 Server 结构 的 配置 选项 


type Server struct { 
Addr string 


Handler Handler 
ReadTimeout time.Duration 
WriteTimeout time.Duration 
MaxHeaderBytes int 


TLSConfig *tls.Config 

TLSNextProto map[string]func(*Server, *tls.Conn, Handler) 
ConnState func(net.Conn, ConnState) 

ErrorLog *log.Logger 


3.2.2 ”通过 HTTPS 提 供 服务 


当 客户 端 和 服务 器 需要 共享 密码 或 者 信用 卡 信息 这 样 的 私密 信息 
时 ， 大 多 数 网 站 都 会 使 用 HTTPS 对 客户 端 和 服务 需 之 间 的 通信 进行 加 
密 和 保护 。 在 一 些 情 况 下 ， 这 种 保护 甚至 是 强制 性 的 。 比 如 说 ， 如 果 
一 个 网 站 提供 了 信用 卡 文 付 功能 ， 那 么 按照 文 付 卡 行业 数据 安全 标准 
(Payment Card Industry Data Security Standard) ， 这 个 网 站 就 必须 对 客 

户 闪 和 服务 右 之 间 的 通信 进行 加 密 。 像 Gmail 和 Facebook 这 样 市 有 隐私 
性 质 的 网 站 甚至 在 整个 网 站 上 都 启用 了 HTTPS。 如 采 你 打算 开发 一 个 
网 站 ， 而 这 个 网 站 又 需要 提供 用 户 登 录 功 能 ， 那 么 你 也 需要 在 这 个 网 
站 上 局 用 HTTPS。 


HTTPS 实 际 上 就 是 将 HTTP 通 信 放 到 SSL 之 上 进行 。 通 过 使 用 
ListenAndServeTLS 函数 ， 我 们 可 以 让 之 前 展示 过 的 简单 Web 应 用 
也 提供 HTTPS 服 务 ， 代 码 清 单 3-4 展 示 了 具体 的 实现 代码 。 


代码 清单 3-4 ”通过 HTTPS 提 供 服务 


package main 


import ( 
"net/http" 
) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: nil, 


} 


server.ListenAndServeTLS("cert.pem", "key.pem") 


这 段 代 码 中 的 cert ,pem 文件 是 SSL 证 书 ， 而 key . pem 则 是 服务 
句 的 私 钥 (private key) 。 在 生产 环境 中 使 用 的 SSL 证 书 需 要 通过 
VeriSign、Thawte 或 者 Comodo SSL 这 样 的 CA 取得 ， 但 如 有 果 是 出 于 测试 
目的 才 使 用 证 书 和 私 钥 ， 那 么 使 用 自行 生成 的 证 书 束 可 以 了 。 生 成 证 
书 的 办 法 有 很 多 种 ， 其 中 一 种 就 是 使 用 Go 标准 库 中 的 crypto 包 群 
(library group) ° 


=r TS 和 | 


SSL (Secure Socket Layer， 安 全 套 接 字 层 ) 是 一 种 通过 公 钥 基础 设施 (Public Key 
Infrastructure, PKI) 为 通信 双方 提供 数据 加 密 和 身份 验证 的 协议 ， 其 中 通信 的 双方 通常 是 客 | 
户 端 和 服务 器 。SSL 最 初 由 Netscape 公 司 开发 ， 之 后 由 IETF (Internet Engineering Task Force, : 
互联 网 工程 任务 组 ) 接手 并 将 其 改名 为 TLS (Transport Layer Security， 传 输 层 安全 协议 ) 。 | 


=] væ 


HTTPS， 即 SSL 之 上 的 HTTP， 实 际 上 就 是 在 SSL/TLS 连 接 的 上 层 进 行 HTTP 通 信 。 


HTTPS 需 要 使 用 SSL/TLS 证 书 来 实现 数据 加 密 以 及 身份 验证 (本 书 使 用 SSL 证 书 这 一 名 
， 因 为 它 更 常用 ) 。SSL 证 书 存储 在 服务 器 之 上 ， 它 是 一 种 使 用 X.509 格 式 进行 格式 化 的 数 
据 ， 这 些 数据 包含 了 公 钥 以 及 其 他 一 些 相关 信息 。 为 了 保证 证 书 的 可 靠 性 ， 证 书 一 般 由 证 书 
分 发 机 构 (Certificate Authority, CA) 签发 。 服 务 器 在 接收 到 客户 端 发 送 的 请 求 之 后 ， 会 将 | 
书 和 响应 一 并 返回 给 客户 端 ， 而 客户 端 在 确认 证 书 的 真实 性 之 后 ， 就 会 生成 一 个 随机 密 铀 
(random key) ， 并 使 用 证 书 中 的 公 钥 对 随机 密 钥 进行 加 密 ， 此 次 加 密 产生 的 对 称 密 铀 。” 
(symmetric key) 就 是 客户 端 和 服务 器 在 进行 通信 时 ， 人 负责 对 通信 实施 加 密 的 实际 密 铀 
(actual key) ° 
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虽然 我 们 不 会 在 生产 环境 中 使 用 自行 生成 的 证 书 和 私 钥 ， 但 了 解 
SSL 证 书 和 私 钥 的 生成 方法 ， 并 学 会 如 何在 开发 和 测试 的 过 程 中 使 用 证 
书 和 私 铀 ， 也 是 一 件 非常 有 意义 的 事情 。 代 码 清 单 3-5 展 示 了 生成 SSL 
证 书 以 及 服务 姻 私 钥 的 具体 代码 。 


代码 清单 3-5 ”生成 个 人 使 用 的 SSL 证 书 以 及 服务 器 私 钥 


package main 


import ( 
"crypto/rand" 
"crypto/rsa" 
"crypto/x509" 
"crypto/x509/pkix" 
"encoding/pem" 
"math/big" 
"net" 
Nos" 
"time" 


) 


func main() { 
max := new(big.Int).Lsh(big.NewInt(1), 128) 
serialNumber, _ := rand.Int(rand.Reader, max) 
subject := pkix.Name{ 
Organization: []string{"Manning Publications Co."}, 
OrganizationalUnit: []string{"Books"}, 
CommonName : "Go Web Programming", 


} 


template := x509.Certificate{ 
SerialNumber: serialNumber, 


Subject: subject, 

NotBefore: time .Now(), 

NotAfter: time.Now().Add(365 * 24 * time.Hour), 
KeyUsage: x509.KeyUsageKeyEncipherment | 


x509.KeyUsageDigitalSignature, 
ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, 
IPAddresses: []net.IP{net.ParseIP("127.0.0.1")}, 
} 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, 

=&template, &pk.PublicKey, pk) 

certOut, _ := os.Create("cert.pem" ) 

pem.Encode(certOut, &pem.Block{Type: "CERTIFICATE", Bytes: 
derBytes}) 

certOut.Close( ) 


keyOut, _ := os.Create("key.pem") 

pem.Encode(keyOut, &pem.Block{Type: "RSA PRIVATE KEY", Bytes: 
=x509.MarshalPKCS1iPrivateKey (pk) }) 

keyOut .Close() 


生成 SSL 证 书 和 密 钥 的 步骤 并 不 是 特别 复杂 。 因 为 SSL 证 书 实际 上 
就 是 一 个 将 扩展 密 钥 用 法 (extended key usage) 设置 成 了 服务 器 身份 验 
证 操作 的 X.509 证 书 ， 所 以 程序 在 生成 证 书 时 使 用 了 crypto/x509 标 
准 库 。 此 外 ， 因 为 创建 证 书 需要 用 到 私 铀 ， 所 以 程序 在 使 用 私 钥 成 功 
创建 证 书 之 后 ， 会 将 私 钥 单独 保存 在 一 个 存放 服务 器 私 钥 的 文件 里 
H o 


让 我 们 来 仔细 分 析 一 下 代码 清单 3-5 中 的 主要 代码 吧 。 首 先 ， 程 序 
使 用 一 个 Certificate 结构 来 对 证 书 进行 配置 : 


template := x509.Certificate{ 
SerialNumber: serialNumber, 
Subject: subject, 
NotBefore: time.Now(), 
NotAfter: time.Now().Add(365*24*time.Hour), 


KeyUsage: x509.KeyUsageKeyEncipherment | 
x509.KeyUsageDigitalSignature, 

ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, 

IPAddresses: []net.IP{net.ParseIP("127.0.0.1")}, 


结构 中 的 证 书 序列 号 (SerialNumber ) 用 于 记录 由 CA 分 发 的 唯 
一 号 码 ， 为 了 能 让 我 们 的 Web 应 用 运行 起 来 ， 程 序 在 这 里 生成 了 一 个 非 
常 长 的 随机 整数 来 作为 证 书 序列 号 。 之 后 ， 程 序 创建 了 一 个 专 有 和 名称 

(distinguished name) ， 并 将 它 设 置 成 了 证 书 的 标题 (subject) 。 此 

外 ， 程 序 还 将 证 书 的 有 效 期 设置 成 了 一 年 ， 而 结构 中 KeyUsage 字段 
和 ExtKeyUsage 字段 的 值 则 表明 了 这 个 X.509 证 书 是 用 于 进行 服务 器 
身份 验证 操作 的 。 最 后 ， 程 序 将 证 书 设置 成 了 只 能 在 IP 地 址 127.0.0.1 之 
Fer 


X.509 是 国际 电信 联盟 电信 标准 化 部 门 (ITU-T) 为 公 钥 基 础 设施 制定 的 一 个 标准 ， 这 个 
标准 包含 了 公 钥 证 书 的 标准 格式 。 


一 个 X.509 证 书 (简称 SSL 证 书 ) 实际 上 就 是 一 个 经 过 编码 的 ASN.1 (Abstract Syntax 
Notation One， 抽 和 象 语法 表示 法 /1) 格式 的 电子 文 要 。 ASN.1 既 是 一 个 标准 ， 也 是 一 种 表示 
法 ， 它 描述 了 表示 电信 以 及 计算 机 网 络 数据 的 规则 和 结构 。 


X.509 证 书 可 以 使 用 多 种 格式 编码 ， 其 中 一 种 编码 格式 是 BER (Basic Encoding Rules, 基 
本 编码 规则 ) 。BER 格 式 指定 了 一 种 自 解释 并 且 自 定义 的 格式 用 于 对 ASN .1 数据 结构 进行 编 
码 ， 而 DER 格式 则 是 BER 的 一 个 子 集 。DER 只 提供 了 一 种 编码 ASN.1 值 的 方法 ， 这 种 方法 被 
广泛 地 应 用 于 密码 学 当中 ， 尤 其 是 对 X.509 证 书 进行 加 密 。 : 


SSL 证 书 可 以 以 多 种 不 同 的 格式 保存 ， 其 中 一 种 是 PEM (Privacy Enhanced Email， 隐 私 | 
增强 邮件 ) 格式 ， 这 种 格式 会 对 DER 格式 的 X.509 证 书 实施 Base64 编 码 ， 并 且 这 种 格式 的 文件 
都 以 ----- BEGIN CERTIFICATE----- Wk, W----- END CERTIFICATE----- 结尾 | 

(除了 用 作文 件 格式 之 外 ，PEM 和 此 处 讨论 的 SSL 证 书 关系 并 不 大 ) 。 | 


在 此 之 后 ， 程 序 通 过 调用 crypto/rsa 标准 库 中 的 GenerateKkey 
函 数 生 成 了 一 个 RSA 私 钥 : 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


FEF BVEWIRSA AFA BL SSE FP RIASA 
(public key) ， 这 个 公 钥 在 使 用 x509 ,CreateCcertificate 函数 创 
建 SSL 证 书 的 时 候 就 会 用 到 : 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, 
&template, 


=&pk.PublicKkey, pk) 


CreateCertificate WAU ZCertificate 结构 、 公 铀 和 私 
钥 等 多 个 参数 ， 创 建 出 一 个 经 过 DER 编码 格式 化 的 字 节 切片 。 后 续 代 
码 的 意图 也 非常 简单 明了 ， 它 们 首先 使 用 encoding/pem 标准 库 将 证 
书 编码 到 cert ,pem 文件 里 面 : 


certOut, _ := os.Create("cert.pem") 

pem.Encode(certOut, &pem.Block{Type: "CERTIFICATE", Bytes: 
derBytes}) 

certOut.Close( ) 


然后 继续 以 PEM 编 码 的 方式 把 之 前 生成 的 密 钥 编码 并 保存 到 
key .pem 文 件 里 面 : 


keyOut, _ := os.Create("key.pem") 
pem.Encode(keyOut, &pem.Block{Type: "RSA PRIVATE KEY", Bytes: 


=x509.MarshalPKCS1PrivateKey (pk) }) 
keyOut .Close() 


最 后 需要 提醒 的 是 ， 如 果 证 书 是 由 CA 签发 的 ， 那 么 证 书 文件 中 将 
RY Oe Rs ae eR CARA, KR PWG arse eR, CARTE 
后 。 


3.3 ADEE SS AA as EN SN 


在 前 面 的 内 容 中 ， 我 们 启动 了 一 个 web 服务器 ， 但 是 因为 这 个 服务 
器 尚未 实现 任何 功能 ， 所 以 现在 访问 这 个 服务 器 只 会 获得 一 个 404 
HTTP 啊 应 代码 。 出 现 这 一 问题 的 原因 在 于 我 们 尚未 为 服务 器 编写 任何 
处 理 右 ， 所 以 服务 器 的 多 路 复 用 壤 在 接收 到 请 求 之 后 找 不 到 任何 处 理 
句 来 处 理 请 求 ， 因 此 它 只 能 返回 一 个 404 响 应 。 为 了 让 服务 右 能 够 产生 
实际 的 行为 ， 我 们 需要 为 之 编写 处 理 器 。 


3.3.1 ”处 理 请 求 


前 面 的 第 1 章 和 第 2 章 曾 经 简单 地 介绍 过 处 理 器 以 及 处 理 器 范 数 ， 
现在 是 时 候 详 细 地 谈 谈 它们 的 定义 了 。 在 Go 语言 中 ， 一 个 处 理 器 就 是 
一 个 拥有 ServeHTTP 方法 的 接口 ， 这 个 ServeHTTP 方法 需要 接受 两 
个 参数 : 第 一 个 参数 是 一 个 ResponseWriter 接口 ， 而 第 二 个 参数 则 
是 一 个 指向 Request 结构 的 指针 。 换 句 话 说 ， 任 何 接 口 只 要 拥有 一 个 
ServeHTTP 方法 ， 并 且 该 方法 带 有 以 下 签名 (signature) ， 那 么 它 就 
是 一 个 处 理 器 : 


ServeHTTP(http.Responsewriter, *http.Request) 


现在 ， 证 我 们 暂时 离 题 一 下 ， 回 答 一 个 在 阅读 本 章 时 可 能 会 出 现 
在 你 脑海 里 面 的 问题 :既然 ListenAndServe 接受 的 第 二 个 参数 是 一 
个 处 理 器 ， 那 么 为 何 它 的 默认 值 却 是 多 路 复 用 器 Defau1ltServeMux 
WE? 


这 是 因为 DefaultServeMux 多 路 复 用 器 是 ServeMux 结构 的 一 
个 实例 ， 而 后 者 也 拥有 上 面 提 到 的 ServeHTTP 方法 ， 并 且 这 个 方法 的 
签名 与 成 为 处 理 器 所 需 的 签名 完全 一 致 。 换 名 话说 ， 
DefaultServeMux 既是 ServeMux 结构 的 实例 ， 也 是 Handler 结构 
的 实例 ， 因 此 DefaultServeMux 不 仅 是 一 个 多 路 复 用 器 ， 它 还 是 一 
个 处 理 器 。 不 过 DefaultServeMux 处 理 器 和 其 他 一 般 的 处 理 器 不 
同 ，DefaultServeMux 是 一 个 特殊 的 处 理 右 ， 它 唯一 要 做 的 就 是 根 
据 请 求 的 URL 将 请 求 重 定向 到 不 同 的 处 理 器 。 在 了 解 了 这 些 知 识 之 
后 ， 我 们 现在 只 需要 自行 编写 一 个 处 理 器 并 使 用 它 去 代替 默认 的 多 路 
复 用 器 ， 束 可 以 让 服务 器 正常 地 对 客户 端 进行 响应 了 ， 有 具体 如 代码 清 
单 3-6 所 示 。 


代码 清单 3-6 ”处 理 请 求 


package main 


import ( 
UL! fmt UL! 
"net/http" 
) 


type MyHandler struct{} 


func (h *MyHandler) ServeHTTP(w http.Responsewriter, r 
*http.Request) { 

fmt.Fprintf(w, "Hello World!") 
} 


func main() { 
handler := MyHandler{} 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: &handler, 


server .ListenAndServe( ) 
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问 地 址 http://localhost:8080/， 我 们 就 可 以 在 浏览 絮 里 面 看 到 Hello World 
响应 了 。 


有 趣 的 是 ， 如 来 我 们 使 用 浏览 器 访 问 
http://localhost:8080/anything/at/all， 同 样 会 看 到 相同 的 Hello Worldi 
应 。 造 成 这 个 问题 的 原因 非常 明显 : 在 代码 清单 3-6 中 ， 程 序 创建 了 一 
个 处 理 器 并 将 它 与 服务 圳 进行 了 绑 定 ， 以 此 来 代替 原本 正在 使 用 的 于 
认 多 路 复 用 器 。 这 意味 着 服务 器 不 会 再 通过 URL 匹 配 来 将 请 求 路 由 至 
不 同 的 处 理 釉 ， 而 是 直接 使 用 同一 个 处 理 需 来 处 理 所 有 请 求 ， 因 此 无 
论 浏览 器 访问 什么 地 址 ， 服 务 絮 返回 的 都 是 同样 的 Hello World 啊 应 。 


这 也 二 我 们 在 Web 应 用 中 使 用 多 路 复 用 万 的 原因 : 对 茶 些 特殊 用 途 
的 服务 万 来 说 ， 只 使 用 一 个 处 理 融 也 许 束 可 以 很 好 地 完成 工作 了 ， 但 
征 在 大 部 分 情况 下 ， 我 们 还 是 布 望 服务 融 可 以 根据 不 同 的 URL 请 求 返 
回 不 同 的 啊 应 ， 而 不 是 一 成 不 要 地 只 返回 一 种 啊 应 。 


3.3.2 ”使 用 多 个 处 理 器 


在 大 部 分 情况 下 ， 我 们 并 不 希望 像 代码 清单 3-6 那 样 ， 使 用 一 个 处 
理 亏 去 处 理 所 有 请 求 ， 而 是 希望 使 用 多 个 处 理 瑚 去 处 理 不 同 的 URL 。 


为 了 做 到 这 一 点 ， 我 们 不 再 在 Server 结构 的 Handler 字段 中 指定 处 
理 器 ， 而 是 让 服务 器 使 用 默认 的 DefaultServeMux 作为 处 理 器 ， 然 
后 通过 http .Handle ay hee ashe SDefaultServemMux 。 需 
要 注意 的 是 ， 虽 然 Handle 函数 来 源 于 http 包 ， 但 它 实 际 上 是 
ServeMux 结构 的 方法 : 这 些 函 数 是 为 了 操作 便利 而 创建 的 函数 ， 调 
用 它们 等 同 于 调用 DefaultServeMux 的 某 个 方法 。 比 如 说 ， 调 用 
http.Handle 实际 上 就 是 在 调用 DefaultServeMux 的 Handle 方 


法 。 


在 代码 清单 3-7 中 ， 程 序 创 建 了 两 个 处 理 器 ， 并 将 它们 与 各 自 的 
URL 进 行 了 绑 定 。 现 在 ， 访 问 地 址 http:Wlocalhost:8080hello 将 会 
到 “Hello!”*”， 而 访问 地 http://localhost:8080/world 则 会 看 到 “World!”。 


代码 清单 3-7 使 用 多 个 处 理 器 对 请 求 进行 处 理 


package main 


import ( 
UL! fmt " 
"net/http" 
) 


type HelloHandler struct{} 
func (h *HelloHandler) ServeHTTP (w http.Responsewriter, r 
*http.Request) { 
fmt.Fprintf(w, "Hello!") 
} 
type WorldHandler struct{} 
func (h *WorldHandler) ServeHTTP (w http.ResponseWriter, r 


*http.Request) { 
fmt.Fprintf(w, "World!") 
} 


func main() { 


hello 
world 


HelloHandler {} 
WorldHandler {} 


server := 
Addr: 


http.Server{ 
"127.0.0.1:8080", 


} 


http.Handle("/hello", 
http.Handle("/world", 


server .ListenAndServe( ) 


&hello) 
&wor ld) 


3.3.3 “处理 器 函数 
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ResponseWriter 和 指向 Request 结构 的 指针 作为 参数 。 代 码 清单 


3-8 展 示 了 如 何在 服务 
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代码 清单 3-8 使 用 处 理 器 函数 处 理 请 求 


package main 


import ( 
UL! fmt " 
"net/http" 
) 


func hello(w http.Responsewriter, 


fmt.Forintf(w, "Hello!") 


} 


func world(w http.Responsewriter, 


fmt.Fprintf(w, "World!") 


func main() { 


server := http.Server{ 


r *http.Request) { 


r *http.Request) { 


Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/hello", hello) 
http.HandleFunc("/world", world) 


server .ListenAndServe( ) 


处 理 器 函数 的 实现 原理 是 这 样 的 : Go 语言 拥有 一 种 HandlerFunc 
函数 类 型 ， 它 可 以 把 一 个 带 有 正确 签名 的 函数 f 转换 成 一 个 带 有 方法 f 
的 Handler 。 比 如 说 ， 对 下 面 这 个 hello 函数 来 说 : 


func hello(w http.Responsewriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 


} 


程序 只 需要 执行 以 下 代码 : 


helloHandler := HandlerFunc(hello) 


就 可 以 把 helloHandler 设置 成 一 个 Handler 。 如 果 你 对 此 感到 疑 
惑 ， 那 么 不 妨 回顾 一 下 之 前 展示 过 的 接受 处 理 器 的 服务 器 代码 ; 


package main 


import ( 
UL! fmt " 
"net/http" 


type HelloHandler struct{} 
func (h*HelloHandler) ServeHTTP(w thhp.Responsewriter, r 


*http.Request){ 
fmt.Fprintf(w, "Hello! ") 


} 
type WorldHandler struct{} 


func (h *WorldHandler) ServeHTTP (w http.Responsewriter, r 
*http.Request) { 
fmt.Fprintf(w, "World!") 


func main () { 
hello := HelloHandler {} 
world := WorldHandler {} 


server := thhp.Server{ 

Addr: "127.0.0.1:8080", 
} 
http.Handle("/hello", &hello) 


http.Handle("/world", &world) 


server .ListenAndServe( ) 


这 个 程序 使 用 了 以 下 这 行 代码 来 绑 定 URL 地 址 /hello 和 hello 


RL: 
http.Handle("/hello", &hello) 


这 行 代码 向 我 们 展示 了 Handle 画 数 将 一 个 处 理 需 绑 定 至 URL 的 具 
体 方 法 。 此 外 ， 在 接受 处 理 絮 函数 的 代码 清单 3-8 中 ，HandleFunc Kj 
数 会 将 hello 玉 数 转换 成 一 个 Handler ， 并 将 它 与 
DefaultServeMux 进行 绑 定 ， 以 此 来 简化 创建 并 绑 定 Handler WI 


作 。 换 句 话 说 ， 处 理 右 函数 只 不 过 是 创建 处 理 器 的 一 种 便利 的 方法 而 
已 。 代 码 清 单 3-9 展 示 了 http.HandleFunc 函数 的 具体 定义 。 


代码 清单 3-9 http.HandleFunc WRR 


func HandleFunc(pattern string, handler func(Responsewriter, 
*Request)) { 


DefaultServeMux.HandleFunc(pattern, handler) 


} 


而 下 面 是 ServeMux ,HandleFunc 方法 的 定义 : 


func (mux *ServeMux) HandleFunc(pattern string, handler 
func(Responsewriter, 


*Request)) { 
mux.Handle(pattern, HandlerFunc(handler ) ) 


} 


注意 这 个 方法 是 如 何 使 用 HandlerFunc 函数 将 传 入 的 handler 
函数 转换 成 真正 的 处 理 器 的 。 


虽然 处 理 器 函数 能 够 完成 跟 处 理 器 一 样 的 工作 ， 并 且 使 用 处 理 需 
函数 的 代码 比 使 用 处 理 豆 的 代码 更 为 整洁 ， 但 是 处 理 种 函数 并 不 能 完 
全 代 奉 处 理 侨 。 这 是 因为 在 某 些 情况 下 ， 代 码 可 能 已 经 包含 了 某 个 接 
口 或 者 某 种 类 型 ， 这 时 我 们 只 需要 为 它们 添加 ServeHTTP 方法 就 可 以 
将 它们 转变 为 处 理 器 了 ， 并 且 这 种 转变 也 有 助 于 构建 出 更 为 模块 化 的 
Web 应 用 。 


3.3.4” 早 联 多 个 处 理 器 和 处 理 器 函数 


尽管 Go 语言 并 不 十 一 | 函数 式 编 程 语言， 但 它 也 拥有 一 些 钞 数 式 
编程 语言 的 特性 ， 如 函数 类 型 、 匿 名 函数 和 闭 包 。 正 如 前 面 的 代码 所 
示 ， 在 Go 语言 里 面 ， 程 序 可 以 将 一 个 函数 传递 给 另 一 个 函数 ， 又 或 者 
通过 标识 符 去 引用 一 个 具名 函数 。 这 意味 着 ， 程 序 可 以 像 图 3-3 展 示 的 


那样 ， 将 函数 fd 传递 给 另 一 个 函数 f2 ， 然 后 在 函数 f2 执行 完 某 些 操 
作 之 后 调用 f1。 


执行 指定 的 操作 


f1 


输出 
执行 指定 的 操作 


图 3-3 ”串联 起 多 个 处 理 器 


来 看 一 个 完整 的 例子 :假设 我 们 想 要 在 每 个 处 理 右 被 调 用 时 ， 在 
某 个 地 方 记录 下 相应 的 调用 信息 。 为 此 ， 我 们 可 以 在 处 理 万 里 面 添加 
一 些 额 外 的 代码 ， 又 或 者 像 第 2 章 那 样 ， 将 这 些 记 录 代 码 重 构成 一 个 工 
具 函 数 ， 然 后 让 每 个 处 理 融 都 去 调用 这 个 工具 函数 。 虽 然 实 现 上 面 提 
到 的 两 种 方法 并 不 困难 ， 但 引入 额外 代码 的 做 法 会 给 程序 的 编写 带 来 
厅 烦 ， 并 导致 处 理 需 需要 包含 与 处 理 请 求 无 关 的 代码 。 


诸如 日 志 记 录 、 安 全 检查 和 错误 处 理 这 样 的 操作 通常 被 称 为 横 切 
关注 点 (cross-cutting concern) ， 里 然 这 些 操 作 非 常常 见 ， 但 是 为 了 防 
止 代码 重复 和 代码 依赖 问题 ， 我 们 又 不 希望 这 些 操 作 和 正常 的 代码 搁 
和 在 一 起 。 为 此 ， 我 们 可 以 使 用 串联 (chaining) 技术 分 隔 代 码 中 的 横 
切 关 注 点 。 代 码 清单 3-10 展 示 了 一 个 串联 多 个 处 理 器 的 例子 。 


代码 清单 3-10 ”串联 两 个 处 理 器 函数 


package main 


import ( 
UL! fmt UL! 
"net/http" 
"reflect" 
"runtime" 


) 


func hello(w http.Responsewriter, r *http.Request) { 
fmt.Forintf(w, "Hello!") 
} 


func log(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.Responsewriter, r *http.Request) { 
name := 
runtime.FuncForPC(reflect.ValueOf(h).Pointer()).Name() 
fmt.Printin("Handler function called - " + name) 
h(w, r) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/hello", log(hello) ) 
server .ListenAndServe( ) 


} 


Råb ere ethello 之 外 ， 这 个 代码 清单 还 包含 了 一 个 1og K 
数 。1og 函数 接受 一 个 HandlerFunc 类 型 的 函数 作为 参数 ， 然 后 返 
回 男 一 个 HandlerFunc 类 型 的 函数 作为 值 。 因 为 he11o 函数 就 是 一 
个 HandlerFunc 类 型 的 函数 ， 所 以 代码 1og(he1L1o) 实际 上 束 是 将 
hello 函数 发 送 至 1og 函数 之 内 ， 换 名 话说， 这 段 代 码 串 联 起 了 1og 
函数 和 he11o 函数 。 


log 函数 的 返回 值 是 一 个 匿名 函数 ， 因 为 这 个 匿名 函数 接受 一 个 
Responsewriter 和 一 个 Request 指针 作为 参数 ， 所 以 它 实 际 上 也 
是 一 个 HandlerFunc 。 在 匿名 函数 内 部 ， 程 序 首 移 会 获取 被 传 入 的 
HandlerFunc 的 名 字 ， 然 后 再 调用 这 个 HandlerFunc 。 作 为 结 
如 果 我 们 使 用 浏览 器 访问 地 址 http://localhost:8080/hello， 那 么 浏览 器 页 
面 将 显示 以 下 信息 : 


Handler function called - main.hello 


束 像 搭 积 木 一 样 ， 既 然 我 们 可 以 串联 起 两 个 函数 ， 那 么 目 然 也 可 
以 串联 起 更 多 函数 。 串 联 多 个 函数 可 以 让 程序 执行 更 多 动作 ， 这 种 做 
法 有 时 候 也 称 为 管道 处 理 (pipeline processing) ， 如 图 3-4 所 示 。 


执行 指定 的 操作 


输入 


执行 指定 的 操作 
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输出 
执行 指定 的 操作 


图 3-4 ”串联 更 多 处 理 器 


举 个 例子 ， 如 果 我 们 还 有 一 个 protect 函数 ， 它 会 在 调用 传 入 的 
处 理 磊 之 前 验证 用 户 的 喘 份 : 


func protect(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.Responsewriter, r *http.Request) { 
© 


h(w, r) 
} 
} 


OAS Vaal, DESK TBAT Rol AP toe ta OLA AVE 


那么 我 们 只 需要 把 protect 函数 跟 之 前 的 函数 串联 在 一 起 ， 就 可 以 正 
常 使 用 这 个 函数 了 : 


http.HandleFunc("/hello", protect(log(hello) )) 


你 可 能 已 经 注意 到 了 ， 虽 然 我 们 一 直 讨论 的 都 是 如 何 串 联 处 理 
an, (ECCS Ys 3-105¢ hn Eel ce Te aS RK ch Bilas Bn Bo AE MIMS TB E 
B-11FITAN, FREI Ba A) 77 ZS Bop LÆNER AR ae BC OT IZ ev E 
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代码 清单 3-11 串联 多 个 处 理 器 


package main 


import ( 
UL! fmt " 
"net/http" 
) 


type HelloHandler struct{} 


func (h HelloHandler) ServeHTTP (w http.Responsewriter, r 
*http.Request) { 
fmt.Forintf(w, "Hello!") 


func log(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.Responsewriter, r 
*http.Request) { 
fmt.Printf ("Handler called - %T\n", h) 
h.ServeHTTP (w, r) 
}) 
} 


func protect(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.Responsewriter, r 
*http.Request) { 
... @ 
h.ServeHTTP (w, r) 


}) 
} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
hello := HelloHandler{} 
http.Handle("/hello", protect(log(hello))) 
server.ListenAndServe() 
} 


OAS Vaal, DESK T — BEH TRN H A EREE 


让 我 们 来 观察 一 下 代码 清单 3-11 和 代码 清单 3-10 有 什么 区 别 。 代 码 
清单 3-11 中 的 Hello Handler 在 前 面 的 代码 清单 中 已 经 展示 过 ， 它 跟 
代码 清单 3-10 中 的 hello 函数 一 样 ， 都 位 于 串联 链 的 末尾 。 至 于 10g 
函数 则 不 再 接受 和 返回 HandlerFunc 类 型 的 函数 ， 而 是 接受 并 返回 
Handler 类 型 的 处 理 器 : 


func log(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.Responsewriter, r 


*http.Request) { 
fmt .Printf("Handler called - %T\n", h) 
h.ServeHTTP (w, r) 
}) 


} 


log 函数 和 protect KAMET RH EZK, mE 
HandlerFunc 直接 将 匿名 函数 转换 成 一 个 Handler ， 然 后 返回 这 个 
Handler 。 程 序 现 在 也 不 再 直接 执行 处 理 器 函数 了 ， 而 是 调用 处 理 器 
的 ServeHTTP 函数 。 最 后 的 一 点 变化 是 ， 程 序 现 在 绑 定 的 是 处 理 器 而 
不 是 处 理 器 函数 : 


hello := HelloHandler{} 


http.Handle("/hello", protect(log(hello) )) 


除了 以 上 提 到 的 区 别 之 外 ， 两 个 程序 的 其 余 代 码 基 本 上 都 是 相同 
HA) ° 
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框架 部 使 用 了 这 一 技术 。 


3.3.5 ServeMux 和 DefaultServeMux 


本 章 和 前 一 章 都 对 ServeMux 和 DefaultServeMux 进行 了 介 
绍 。ServeMux 是 一 个 HTTP 请 求 多 路 复 用 器 ， 它 负责 接收 HTTP 请 求 
并 根据 请 求 中 的 URL 将 请 求 重 定向 到 正确 的 处 理 器 ， 如 图 3-5 所 示 。 


Se a re 


/hello 


多 路 复 用 器 : 


ServeMux 


处 理 器 
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图 3-5 ”通过 多 路 复 用 器 将 请 求 转发 给 各 个 处 理 器 


ServeMux 结构 包含 了 一 个 映射 ， 这 个 映 喘 会 将 URL 映 射 至 相应 
的 处 理 器 。 正 如 之 前 所 说 ， 因 为 ServeMux 结构 也 实现 了 ServeHTTP 
方法 ， 所 以 它 也 是 一 个 处 理 器 。 当 ServeMux 的 ServeHTTP 方法 接收 
到 一 个 请 求 的 时 候 ， 它 会 在 结构 的 映射 里 面 找 出 与 被 请 求 URL 最 为 匹 
配 的 URL， 人 然后 调用 与 之 相对 应 的 处 理 器 的 ServeHTTP 方法 ， 如 图 3- 
6 所 示 。 
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indexHandler 


ee 
请 求 
/hello helloHandler helloHandler 
GET /hello HTTP/1.1 
worldHandler 
worldHandler 


这 个 结构 负责 将 URL ServeMux 结 构 的 ServeHTTP 
映射 至 处 理 器 。 方法 会 调用 URL 对 应 的 处 理 器 
的 ServeHTTP 方 法 。 


图 3-6 ”多 路 复 用 器 的 工作 原理 


在 介绍 完 ServeMux 之 后 ， 让 我 们 来 了 解 一 下 
DefaultServeMux 。 因 为 ServeMux 是 一 个 结构 而 不 是 一 个 接口 ， 
所 以 DefaultServeMux 并 不 是 ServeMux 的 实现 。Default- 
ServeMux 实际 上 是 ServeMux 的 一 个 实例 ， 并 且 所 有 引入 了 
net/http 标准 库 的 程序 都 可 以 使 用 这 个 实例 。 当 用 户 没 有 为 Server 
结构 指定 处 理 需 时 ， 服 务 右 融会 使 用 DefaultServeMux 作为 
ServeMux 的 默认 实例 。 


此 外 ， 因 为 ServeMux 也 是 一 个 处 理 器 ， 所 以 用 户 也 可 以 在 有 需 
要 的 情况 下 对 其 实例 实施 处 理 器 串联 。 


在 上 面 的 几 个 例子 中 ， 被 请 求 的 URL /hello 完美 地 匹配 了 与 多 
路 复 用 器 绑 定 的 URL， 但 如 果 浏 览 絮 访问 的 是 /random 或 
者 /hello/there ， 那 么 服务 器 又 会 返回 什么 响应 呢 ? 


这 个 问题 的 答案 跟 我 们 绑 定 URL 的 方法 有 关 : 如 果 我 们 像 图 3-6 那 
样 绑 定 根 URL (/) ， 那 么 匹配 不 成 功 的 URL 将 会 根据 URL 的 层级 进行 
下 降 ， 并 最 终 降落 在 根 URL 之 上 。 当 浏 唤 器 访问 /random 的 时 候 ， 
为 服务 器 无 法 找到 负责 处 理 这 个 URL 的 处 理 器 ， 所 以 它 会 把 这 个 URL 
交 给 根 URL 的 处 理 器 处 理 (对 于 图 中 所 示 的 例子 来 说 ， 就 是 使 用 
indexHandler 来 处 理 这 个 URL) 。 


那么 服务 器 又 是 如 何 处 理 /hello/there 的 呢 ? 根据 最 小 惊讶 原 
I) (The Principle of Least Surprise) ， 因 为 程序 已 经 为 /hello Ae s 
处 理 器 ， 所 以 在 默认 情况 下 ， 程 序 似乎 应 该 使 用 helloHandler 处 
理 /hello/there。 但 是 对 图 3-6 所 示 的 例子 来 说 ， 服 务 器 实际 上 会 使 
用 indexHandler 去 处 理 对 /hello/there 的 请 求 。 


最 小 惊讶 原则 ， 也 称 最 小 意外 原则 ， 是 设计 包括 软件 在 内 的 一 切 事物 的 一 条 通用 规则 ， 
它 指 的 是 我 们 在 进行 设计 的 时 候 ， 应 该 做 那些 合乎 常理 的 事情 ， 使 事物 的 行为 总 是 显 而 易 
见 、 始 终 如 一 并 且 合乎 情理 。 


举 个 例子 ， 如 果 我 们 在 一 局 门 的 旁边 放置 一 个 按钮 ， 那么 人 们 就 会 认为 这 个 按钮 与 这 扇 
J 有 关 ， 比 如 ， 按 下 按钮 门铃 会 响 或 者 门 会 自动 打开 ， 等 等 。 但 是 ， 如 :这 个 按钮 被 按 下 时 
会 关 掉 走廊 的 灯光 ， 它 就 违反 了 最 小 惊讶 原则 ， 因 为 这 一 行为 不 符合 人 们 对 这 个 按钮 的 预 


产生 这 种 行为 的 原因 在 于 程序 在 绑 定 helloHandler 时 使 用 的 
URL 是 /hello 而 不 是 /hel10/。 如 果 被 绑 定 的 URL 不 是 以 / AE, 
那么 它 只 会 与 完全 相同 的 UREL 匹 配 ; 但 如 果 被 绑 定 的 URL 以 / 结尾 ， 那 


ZBI (1S KASURL R A BIBS ot SS ABE URLAG IA], ServeMux 也 会 
认定 这 两 个 URL 是 匹配 的 。 


这 也 就 是 说 ， 如 果 与 helloHandler 处 理 器 绑 定 的 URL 
是 /hello/ 而 不 是 /hello ， 那 么 当 浏 览 絮 请 求 /hello/there 的 时 
候 ， 服 务 器 在 找 不 到 与 之 完全 匹配 的 处 理 器 时 ， 就 会 退 而 求 其 次 ， 开 
人 寻找 能 够 与 /hel10/ 匹配 的 处 理 器 ， 并 最 终 找 到 helloHandler 
人 处理 器 。 


3.3.6 ”使 用 其 他 多 路 复 用 器 


因为 创建 一 个 处 理 器 和 多 路 复 用 右 唯 一 需要 做 的 就 是 实现 

ServeHTTP 方法 ， 所 以 通过 上 自行 创建 多 路 复 用 器 来 代替 netVhttp 包 
中 的 ServeMux 是 完全 可 行 的 ， 并 且 目 前 市 面 上 已 经 出 现 了 很 多 第 三 
Fi WS Ba Har AT GEE AY, ECA, Gorilla Toolkit 

(www.gorillatoolkit.org) HÆS ALA =H RR A ae 
它 提供 了 mux 和 pat MTS LPP SE AI ee eS es, MAT 
将 要 介绍 的 则 是 另 一 个 高 效 的 轻 量 级 第 三 方 多 路 复 用 器 一 一 
HttpRouter ° 


ServeMux 的 一 个 缺陷 是 无 法 使 用 变量 实现 URL 模 式 匹配 。 虽然 
在 浏览 器 请 求 /threads 的 时 候 ， 使 用 ServeMux 可 以 很 好 地 获取 并 
显示 论坛 中 的 所 有 帖子 ， 但 如 果 浏 览 器 请 求 的 是 /thread/123 ， 那 么 
要 获取 并 显示 论坛 里 面 了 为 123 的 帖子 就 会 变 得 非常 困难 。 程 序 必 须 对 
URL 进 行 语法 分 析 才 能 提取 出 URL 当 中 的 帖子 ID。 此 外 ， 因 为 受 
ServeMux 实现 URL 模 式 匹配 的 方式 所 限 ， 如 果 我 们 想 要 通 


过 /thread/123/post/456 这 样 的 URL 从 ID 为 123 的 帖子 中 获取 ID 为 
456 的 回复 ， 束 必须 在 程序 里 面 进行 大 量 复杂 的 语法 分 析 ， 并 因此 给 程 
序 带 来 额外 的 复杂 度 。 


与 ServeMux 不 同 ，HttpRouter 包 并 没有 上 面 提 到 的 这 些 限 
制 。 本 世 将 对 HttpRouter 包 最 重要 的 一 部 分 特性 进行 介绍 ， 关 于 这 
个 包 的 更 详细 的 说 明 可 以 在 它 的 文档 页 面 里 面 看 到 : 
https://github.com/julienschmidt/httprouter。 代 码 清单 3-12 展 示 了 一 个 使 
用 HttpRouter 实 现 的 服务 器 。 


代码 清单 3-12 ”使 用 HttpRouter 实 现 的 服务 器 


package main 


import ( 
UL! fmt " 
"github.com/julienschmidt/httprouter" 
"net/http" 

) 


func hello(w http.Responsewriter, r *http.Request, p 
httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name")) 


} 


func main() { 
mux := httprouter.New() 
mux.GET("/hello/:name", hello) 


server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 


} 


server .ListenAndServe( ) 


个 程序 中 的 大 部 分 代码 都 和 之 前 展示 过 的 代码 一 样 ， 只 是 涉及 
和 的 部 分 代码 跟 之 前 有 所 不 同 。 在 这 段 代 码 里 ， 程 序 通过 调 
用 New EKROK BEES 2 KE A 


mux := httprouter.New() 


文 个 程序 不 再 使 用 HandleFunc 绑 定 处 理 器 函数 ， 而 是 直接 把 处 
理 器 函数 与 给 定 的 HTTP 方 法 进行 绑 定 : 


mux.GET("/hello/:name", hello) 


Vik 


这 段 代 码 会 把 给 定 URL 的 GET 方法 与 hello 处 理 器 函数 进行 绑 
定 ， 当 浏览 器 向 这 个 URL 发 送 GET KIT, hello HAGA RIAA, 
但 如 果 浏 览 器 向 这 个 URL 发 送 除 GET 请 求 之 外 的 其 他 请 求 ，hello ki 
数 则 不 会 被 调用 。 需 要 注意 的 是 ， 被 绑 定 的 URL 包 含 了 具名 参数 
(named parameter) ， 这 些 具名 参数 会 被 URL 中 的 具体 值 所 代替 ， 并 
且 程序 可 以 在 处 理 器 里 面 获 取 这 些 值 。 


跟 之 前 的 处 理 需 函数 相 比 ， 现 在 的 he1L1o 处 理 器 函数 也 发 生 了 变 
化 ， 它 不 再 接受 两 个 参数 ， 而 是 接受 3 个 参数 。 其 中 第 三 个 参数 
Params 就 包含 了 之 前 提 到 的 具名 参数 ， 具 名 参数 的 值 可 以 在 处 理 器 内 
部 通过 ByName 方法 获取 : 


func hello(w http.Responsewriter, r *http.Request, p 
httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name") ) 


| | 
程序 的 最 后 一 个 变化 是 它 不 再 使 用 默认 的 DefaultServeMux , 
而 是 通过 将 HttpRouter 传 递 给 Server 结构 来 使 用 这 个 多 路 复 用 器 : 


server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 


server .ListenAndServe( ) 


现在 ， 如 果 我 们 在 终端 上 执行 go build 命令 ， 那 么 编译 器 将 返 


回 一 个 错误 : 


$ go build 

server.go:5:5: cannot find package 

"github.com/julienschmidt/httprouter" in 
any of: 


/usr/local/go/src/github.com/julienschmidt/httprouter (from 
$GOROOT ) 

/Users/sausheong/gws/src/github.com/julienschmidt/httprouter 
(from $GOPATH) 


出 现 这 个 错误 的 原因 在 于 ， 我 们 虽然 指定 了 HttpRoter 库 ， 但 这 个 
第 三 方 库 在 我 们 的 电脑 上 并 不 存在 ， 得 益 于 Go 语言 强大 且 易 用 的 包 管 
理 系统 ， 我 们 只 需要 执行 以 下 命令 就 可 以 解决 这 个 问题 了 : 


$ go get github.com/julienschmidt/httprouter 


在 电脑 连接 了 网 络 的 情况 下 ， 这 个 命令 会 从 HttpRouter 的 GitHub 主 
页 上 下 载 HttpRouter 包 的 源 人 代码， 并 将 其 存储 到 $GOPATH/src HK 


中 。 在 此 之 后 ， 当 我 们 再 次 执行 go build 命令 尝试 编译 代码 清单 3-12 
所 示 的 服务 器 时 ， 编 译 器 就 会 导入 HttpRouter 的 代码 ， 并 对 整个 服务 器 
进行 编译 。 


3.4 ”使 用 HTTP/2 


在 本 章 的 最 后 ， 让 我 们 来 了 解 一 下 如 何 使 用 HTTP/2 构 建 本 章 介绍 
HJ WebH Ra ait ° 


本 书 在 第 1 章 已 经 对 HTTP/2 做 过 简单 的 介绍 ， 并 且 提 到 过 在 1.6 或 
以 上 版 本 的 Go 语言 中 ， 如 果 使 用 HTTPS 模 式 启动 服务 器 ， 那 么 服务 器 
将 默认 使 用 HTTP/2。 但 是 ， 在 默认 情况 下 ， 版 本 低 于 1.6 版 本 的 Go 语言 
将 不 会 安装 http2 包 ， 因 此 用 户 需 要 通过 手动 执行 以 下 命令 来 获取 这 
PE: 


go get "golang.org/x/net/http2" 


为 了 让 代码 清单 3-6 中 构建 的 web 服务 器 用 上 HTTP/2， 我 们 需要 给 
这 个 服务 器 导入 http2 包 ， 并 通过 添加 一 些 代码 行 来 让 服务 器 打开 对 
HTTP/2 的 文 持 。 为 了 做 到 这 一 点 ， 我 们 需要 调用 http2 包 中 的 
ConfigureServer 方法 ， 并 将 服务 硕 配 置 传递 给 亡 ， 修 改 后 的 服务 
器 代 码 如 代码 清单 3-13 所 示 。 


代码 清单 3-13 ”启用 HTTP/2 


package main 


import ( 
UL! fmt UL! 
"golang.org/x/net/http2" 
"net/http" 

) 


type MyHandler struct{} 


func (h *MyHandler) ServeHTTP (w http.Responsewriter, r 
*http.Request) { 

fmt.Fprintf(w, "Hello World!") 
} 


func main() { 
handler := MyHandler{} 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: &handler, 


http2.ConfigureServer(&server, &http2.Server{}) 


server .ListenAndServeTLS("cert.pem", "key.pem") 


} 


现在 ， 我 们 只 要 执行 以 下 代码 就 可 以 局 动 这 个 打开 了 HTTP/2 功 能 
的 web 服务 部 了 : 


go run Server .go 


为 了 检查 服务 器 是 否 运 行 在 HTTP/2 模 式 之 下 ， 我 们 可 以 使 用 cURL 
对 服务 器 进行 检查 。 因 为 cURL 在 很 多 平台 上 都 是 可 用 的 ， 所 以 本 书 会 
经 常 使 用 它 作 为 检测 工具 ， 因 此 现在 是 时 候 来 学 习 一 下 如 何 使 用 cURL 
了 o 


cURL 是 一 个 命令 行 工具 ， 它 可 以 获取 指定 URL 上 的 文件 ， 又 或 者 向 指定 的 URI 发 送 文 
件 。cURL 支 持 数量 庞大 的 常用 互联 网 协议 ， 其 中 就 包括 HTTP 和 HTTPS。cURL 默 认 安 装 在 包 
括 OS X 在 内 的 很 多 Unix 变 种 之 上 ， 并 且 它 同样 可 以 在 Windows 系 统 上 使 用 。 手动 下 载 和 安装 
cURL 的 方法 可 以 通过 页 面 http://curl.haxx.se/download.html 看 到 。 


cURL 从 7.43.0 版 本 开始 支持 HTTP/2， 用 户 在 发 送 请 求 的 时 候 ， 只 
需要 打开 - -http2 标志 (flag) 就 可 以 发 送 HTTP/2 请 求 了 。 此 外 ， 为 
了 让 cURL 能 够 支持 HTTP/2， 用 户 还 必须 将 cURL 与 nghttp2 这 个 提供 
HTTP/2 支 持 的 C 语 言 库 进行 链接 (link) 。 在 据 写 本 节 的 上 时候， 包括 OS 
X 和 平台 在 内 的 很 多 默认 的 cURL 实 现 都 还 没有 提供 对 HTTP/2 的 文 择 ， 因 
此 我 们 可 能 需要 重新 编译 cURL， 将 它 与 nghttp2 库 进行 链接 ， 然 后 
用 编译 后 的 新 版 cURL 代替 原 有 的 cURL 。 


在 完成 重新 编译 cURL 的 工作 之 后 ， 我 们 可 以 使 用 以 下 命令 去 检查 
代码 清单 3-13 展 示 的 Web 应 用 是 否 启用 了 HTTP/2: 


curl -I --http2 --insecure https://localhost:8080/ 


在 默认 情况 下 ，cURL 在 以 HTTP/2 形 式 访 问 一 个 web 应 用 的 时 候 ， 
会 对 应 用 的 证 书 进行 验证 ， 并 在 验证 无 法 通过 时 拒绝 访问 。 ee 
的 Web 应 用 使 用 的 是 自行 创建 的 证 书 和 密 钥 ， 它 们 默认 是 无 法 通过 这 一 
验证 的 ， 所 以 上 面 的 命令 在 调用 cURL 的 时 候 使 用 了 insecure a 
这 个 标志 会 让 cURL 强制 接受 我 们 创建 的 证 书 ， 从 而 使 访问 可 以 顺利 进 
a 


如 果 一 切 顺 利 ，cURL 将 返回 以 下 输出 : 


HTTP/2.0 200 
content-type:text/plain; charset=utf-8 


content-length:12 
date:Mon, 15 Feb 2016 05:33:01 GMT 


本 章 虽 然 详细 介绍 了 如 何 接收 HTTP 请 求 ， 但 是 并 没有 具体 地 说 明 
如 何 处 理 接收 到 的 请 求 ， 以 及 如 何 同 客 户 端 返 回 啊 应 。 虽 然 处 理 套 和 
处 理 吉 函数 是 使 用 Go 编写 Web 应 用 的 关键 ， 但 如 何 处 理 请 求 以 及 如 何 
发 送 啊 应 才 是 Web 应 用 真正 安身 立 命 之 所 在 。 在 接 下 来 的 一 革 中 ， 我 们 
将 深入 学 习 请 求 和 啊 应 的 细 证 ， 了 解 如 何 从 请 求 中 提取 信息 ， 以 及 如 
何 通 过 啊 应 传递 信息 。 


3.5 小结 


。 Go 语言 拥有 一 系列 成 熟 的 标准 库 ， 如 net/http 和 
html/template ， 这 些 标准 库 可 以 用 于 构建 Web 应 用 。 

尽管 使 用 Web 框 架 可 以 更 容易 并 且 更 快捷 地 构建 Web 应 用 ， 但 是 在 
使 用 这 些 框架 之 前 ， 先 了 解 Web 编 程 所 需 的 基础 知识 也 是 非常 重要 
的 。 

Go 语言 的 net/http 标准 库 可 以 将 HTTP 通 信 放 到 SSL 之 上 进行 ， 
也 就 是 通过 HTTPS 方 式 创建 出 更 为 安全 的 通信 连接 。 

Go 语言 的 处 理 器 可 以 是 任何 带 有 ServeHTTP 方法 的 结构 ， 其 中 
ServeHTTP 方法 需要 接收 两 个 参数 : 第 一 个 参数 是 一 个 
Responsewriter 接口 ， 而 第 二 个 参数 则 是 一 个 指向 Request 


结构 的 指针 。 


。 DELEN EK Be bE aT PIT ON YE Boo Ab Ba Es BA FAR 


理 请 求 ， 它 们 跟 ServeHTTP 方法 拥有 相同 的 签名 。 
通过 串联 处 理 需 或 者 处 理 器 函数 ， 可 以 对 程序 中 的 横 切 关注 点 进 
行 分 了 喇 ， 并 以 模块 化 的 方式 处 理 请 求 。 

多 路 复 用 絮 也 是 处 理 絮 。 比 如 ， ServeMux 就 是 一 个 HTTP 请 求 多 
路 复 用 器 ， 它 接受 HTTP 请 求 并 根据 请 求 中 的 URL 将 请 求 重 定 疝 到 
正确 的 处 理 器 。DefaultServeMux 是 ServeMux 的 一 个 公开 的 
实例 ， 这 个 实例 会 被 用 作 默 认 的 多 路 复 用 硕 。 

在 Go 1.6 或 以 上 的 版 本 中 ，net/http 标准 库 默 认 支 持 HTTP/2。 
版 本 低 于 1.6 的 Go 语言 如 果 想 要 获得 HITP/2 文 持 ， 就 需要 手动 添加 
http2 包 。 


第 4 章 ANB 


本 章 主要 内 容 


。 使 用 Go 发 送 请 求 和 响应 

。 使 用 Go 处 理 HTML 表 单 

。 使 用 Responsewriter 向 客户 端 回 传 响应 
。 使 用 cookie 存 储 信息 

。 使 用 cookie 实 现 闪现 消息 


在 前 一 章 ， 我 们 学 习 了 如 何 使 用 Go 语言 内 置 的 net/http 库 创 建 
Web 应 用 服务 器 ， 并 大 此 了 解 了 处 理 器 、 处 理 器 函数 以 及 多 路 复 用 器 。 
在 学 会 了 如 何 接收 请 求 并 将 请 求 转发 给 相应 的 处 理 絮 之 后 ， 本 章 我 们 
要 学 习 的 是 如 何 使 用 Go 提供 的 工具 来 处 理 请 求 ， 以 及 如 何 把 啊 应 回 传 
给 客户 并 。 


4.1 请求 和 啊 应 


本 书 的 第 1 划 对 HTTP 报 文 做 了 不 少 介绍 ， 为 了 加 深 印 象 、 防 止 遗 
起 ， 让 我 们 先 来 回顾 一 下 这 方面 的 知识 。HTTP 报 文 是 在 客户 端 和 服务 
器 之 间 传 递 的 消息 ， 它 分 为 HITP 请 求 和 HTTP 响 应 两 种 类 型 ， 并 且 这 
两 种 类 型 的 报 文 都 拥有 相同 的 结构 : 


(1) 请 求 行 或 者 响应 行 ; 


(4) 一 个 可 选 的 报 文 主体 。 


下 面 是 一 个 GET 请 求 的 例子 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 


User-Agent: Mozilla/5.0 
(empty line) 


Go 语言 的 net/http 库 提供 了 一 系列 用 于 表示 HITP 报 文 的 结构 ， 
为 了 学 习 如 何 使 用 这 个 库 处 理 请 求 和 发 送 啊 应 ， 我 们 必须 对 这 些 结构 
有 所 了 解 。 首 先 ， 让 我 们 来 看 看 net/http 库 中 代表 HTTP 请 求 报 文 的 
Request 结构 。 


4.1.1 Request 结构 


Request 结构 表示 一 个 由 客户 端 发 送 的 HITP 请 求 报 文 。 虽 然 
HTTP 请 求 报 文 是 由 一 系列 文本 行 组 成 的 ， 但 Request 结构 并 不 是 完 
全 按照 报 文 逐 字 逐 句 定义 的 。 实 际 情况 是 ， 这 个 结构 只 包含 了 报 文 在 
经 过 语法 分 析 之 后 ， 其 中 较为 重要 的 信息 ; 除 此 之 外 ， 这 个 结构 还 有 
一 系列 相应 的 方法 可 供 使 用 。 


Request 结构 主要 由 以 下 部 分 组 成 : 


e URL Ex: 


e Header 字段 ; 
。 Body 字段 ; 
e Form 字段、PostForm 字段 和 MultipartForm FÉ ° 


通过 Request 结构 的 方法 ， 用 户 还 可 以 对 请 求 报 文 中 的 cookie、 
引用 URL 以 及 用 户 代理 进行 访问 。 当 net/http 库 被 用 作 HTTP 客 户 端 
WII, Request 结构 既 可 以 用 于 表示 客户 端 将 要 发 送 给 服务 器 的 请 
求 ， 也 可 以 用 于 表示 服务 右 接 收 到 的 客户 端 请 求 。 


4.1.2 KURL 


Request 结构 中 的 URL 字段 用 于 表示 请 求 行 中 包含 的 URL (请 求 
行 也 就 是 HTTP 请 求 报 文 的 第 一 行 ， 这 个 字段 是 一 个 指向 ur1,URL 
结构 的 指针 ， 代 码 清单 4-1 展 示 了 这 个 结构 的 定义 。 


代码 清单 4-1 URL 结构 


type URL struct { 
Scheme string 
Opaque string 
User *Userinfo 
Host string 


Path string 
RawQuery string 
Fragment string 


URL 的 一 般 格 式 为 : 


scheme://[userinfo@]host/path[?query][#fragment] 


那些 在 scheme 之 后 不 带 斜 线 的 URL 则 会 被 解释 为 : 


scheme:opaque[?query][#fragment] 


在 开发 Web 应 用 的 时 候 ， 我 们 党 第 会 让 客户 端 通过 URL 的 查询 参数 
向 服务 器 传递 信息 ， 而 URL 结 构 的 RawQuery 字段 记录 的 就 是 客户 端 
回 服务 器 传递 的 得 询 参 数字 符 串 。 举 个 例子 ， 如 果 客 户 端 癌 地 址 
http://www.example.com/post?id=123&thread id=456 发 送 一 个 请 求 ， 那 
么 RawQuery 字段 的 值 就 会 被 设置 为 d=123&thread_id=456 ° $ 
然 通 过 对 RawQuery 字段 的 值 进行 语法 分 析 可 以 获取 到 键 值 对 格式 的 
查询 参数 ， 但 直接 使 用 Request 结构 的 Form 字段 来 获取 这 些 键 值 对 
会 更 方便 一 些 。 本 章 稍 后 就 会 对 Request 结构 的 Form 字段 、 
PostForm 字段 和 MultipartForm 字段 进行 介绍 。 


另外 需要 注意 的 一 点 是 ， 如 果 请 求 报 文 是 由 浏览 器 发 送 的 ， 那 么 
程序 将 无 法 通过 URL 结构 的 Fragment 字段 获取 URL 的 片段 部 分 。 本 
书 在 第 1 昔 中 就 提 到 过 ， 浏 唤 器 在 向 服务 器 发 送 请 求 之 前 ， 会 将 URL 中 
的 片段 部 分 剔除 掉 一 一 因为 服务 器 接收 到 的 都 是 不 包含 片段 部 分 的 
URL， 所 以 程序 自然 也 无 法 通过 Fragment 字段 去 获取 URL 的 片段 音 
分 了 ， 造 成 这 个 问题 的 原因 在 于 浏览 器 ， 与 我 们 正在 使 用 的 net/http 
库 无 天 。URL 结构 的 Fragment 字段 之 所 以 会 存在 ， 是 因为 并 非 所 有 
请 求 都 来 自 浏 览 器 : 除了 浏览 器 发 送 的 请 求 之 外 ， 服 务 器 还 可 能 会 接 
收 到 HTITP 客 户 端 库 、Angular 这 样 的 客户 端 框 织 或 者 某 些 其 他 工具 发 送 
的 请 求 ， 此 外 别 忘 了 ， 不 仅 服 务 器 程序 可 以 使 用 Request 结构 ， 客 户 
端 库 也 同样 可 以 把 Redquest 结构 用 作 自 己 的 一 部 分 。 


413 ”请 求 首部 


请 求 和 响应 的 首部 都 使 用 Header 类 型 描述 ， 这 种 类 型 使 用 一 个 映 
射 来 表示 HTTP 首部 中 的 多 个 键 值 对 。Header 类 型 拥有 4 种 基本 方法 ， 
这 些 方法 可 以 根据 给 定 的 键 执行 添加 、 删 除 、 获 取 和 设置 值 等 操作 。 


一 个 Header 类 型 的 实例 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 
而 键 的 值 则 是 由 任意 多 个 字符 串 组 成 的 切片 。 为 Header 类 型 设置 首部 
以 及 添加 首部 都 是 非常 简单 的 ， 但 了 解 这 两 种 操作 之 间 的 区 别 有 助 于 
更 好 地 理解 Header 类 型 的 构造 : 在 对 Header 执行 设置 操作 时 ， 给 定 
键 的 值 首 先 会 被 设置 成 一 个 空白 的 字符 串 切片 ， 然 后 该 切 厂 中 的 第 一 
个 元 素 会 被 设置 成 给 定 的 首部 值 ， 而 在 对 Header 执行 添加 操作 上 时， 给 
定 的 首部 值 会 被 添加 到 字符 串 切 片 已 有 元 素 的 后 面 ， 如 图 4-1 所 示 。 


在 为 键 添加 新 的 首部 值 时 ， 一 个 
新 元 素 将 被 追加 到 键 对 应 的 字符 
串 切 片 末 尾 。 


图 4-1 一 个 首部 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 值 为 字符 串 切 片 


代码 清单 4-2 展 示 了 读 取 请 求 首部 的 方法 。 


代码 清单 4-2 读 取 请 求 首部 


package main 


import ( 
" fmt Ul 
"net/http" 
) 


func headers(w http.Responsewriter, r *http.Request) { 
h := r.Header 
fmt.Fprintln(w, h) 


func main() < 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/headers", headers) 
server.ListenAndServe() 


} 


这 个 代码 清单 中 展示 的 服务 器 跟 我 们 在 第 3 章 看 到 过 的 服务 器 基本 
上 是 一 样 的 ， 唯 一 的 区 别 在 于 这 个 服务 器 会 把 请 求 的 首部 打印 出 来 。 
图 4-2 展 示 了 在 OS X 系 统 的 Safari 浏 览 器 上 访问 这 个 服务 器 的 结果 。 


eee < 127.0.0.1:8080/neaders Č 由 r 


map[Connection: [keep-alive] Accept-Encoding: [gzip, deflate) 
Accept: 

[text /html,application/xhtml+xml,application/xml;q-0.9,*/*;q=0. 
8) User-Agent: (Mozilla/S.0 (Macintosh; Intel Mac OS X 10 10 2) 
AppleWebKit/600.3.18 (KHTML, like Gecko) Version/8.0.3 
Safari/600.3.18] Accept-Language: (en-us) Dnt:[1]] 


图 4-2 在 浏览 器 上 展示 的 首部 打印 结果 


如 采 想 要 获取 的 是 某 个 特定 的 首部 ， 而 不 是 请 求 的 所 有 首部 ， 那 


么 可 以 把 服务 紫 中 的 


E 


h := r.Header["Accept-Encoding"] 


这 样 一 来 ， 程 序 就 会 得 到 "Accept -Encoding'" 键 的 首部 值 : 


[gzip, deflate] 


除 此 之 外 ， 我 们 还 可 以 使 用 以 下 语句: 


= r.Header.Get("Accept -Encoding" ) 


| 
I 
1 


并 得 到 以 下 结 采 : 


gzip, deflate 


注意 以 上 两 条 语句 之 间 的 区 别 : 直接 引用 Header 将 得 到 一 个 字 
从 捉 切 片 ， 而 在 Header 上 调用 Get 方法 将 返回 字符 串 形式 的 首部 
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41.4 ”请 求 主体 


请 求 和 响应 的 主体 都 由 Request 结构 的 Body 字段 表示 ， 这 个 字 
段 是 一 个 io ,Read Closer 接 口 ， 该 接口 既 包 含 了 Reader 接口 ， 也 包 
含 了 Closer 接口 。 其 中 Reader 接口 拥有 Read 方法 ， 这 个 方法 接受 
一 个 字 节 切片 为 输入 ， 并 在 执行 之 后 返回 被 读 取 内 容 的 字 节 数 以 及 一 
个 可 选 的 错误 作为 结果 而 Closer 接口 则 拥有 Close 方法 ， 这 个 方 

法 不 接受 任何 参数 ， 但 会 在 出 错时 返回 一 个 错误 。 同 时 包含 Reader fz 
口 和 Closer 接口 意味 着 用 户 可 以 对 Body 字段 调用 Read 方法 和 
Close 方法 。 作 为 例子 ， 代 码 清单 4-3 展 示 了 如 何 使 用 Read 方法 读 取 
请 求 主体 的 内 容 。 


代码 清单 4-3” 读 取 请 求 主体 中 的 数据 


package main 


import ( 
UL! fmt UL! 


"net/http" 
) 


func body(w http.Responsewriter, r *http.Request) { 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) 
fmt.Fprintin(w, string(body) ) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/body", body) 
server .ListenAndServe( ) 


这 段 程序 首先 通过 ContentLength 方法 获取 主体 数据 的 字 节 长 
度 ， 接 着 根据 这 个 长 度 创建 一 个 字 节 数组 ， 然 后 调用 Read 方法 将 主体 
数据 读 取 到 字 贡 数组 中 。 


因为 GET 请 求 并 不 包含 报 文 主体 ， 所 以 如 果 我 们 想 要 测试 这 个 服 
务 器 ， 就 需要 给 它 发 送 POST 请 求 。 正 如 之 前 所 说 ， 浏 览 器 一 般 需要 通 
过 HTML 表 单 才 能 发 送 POST 请 求 ， 但 是 因为 本 书 在 下 一 方才 会 开始 介 
绍 HTML 表 单 ， 所 以 这 里 我 们 暂且 就 先 使 用 HTTP 客 户 端 来 测试 服务 
如 。 市 面 上 可 用 的 HTTP 客 户 端 非常 多 ， 既 有 吕 面 版 的 图 形 HTTP 客 户 
端 ， 也 有 浏览 器 插件 或 者 扩展 ， 还 有 cURL 等 命令 行程 序 可 供 选 择 。 


作为 例子 ， 以 下 命令 展示 了 如 何 使 用 cUREL 回 服务 器 发 送 一 条 POST 
请 求 : 


$ curl -id "first_name=sausheong&last_name=chang" 


127.0.0.1:8080/body 


cUREL 在 接收 到 响应 之 后 将 回 用 户 返 回 一 段 完 整 并 且 未 经 处 理 的 
HTTP 吧 应 ， 其 中 位 于 衬 行 之 后 的 束 是 HTTP 的 主体 。 以 下 展示 的 束 是 
上 面 的 cURL 命令 返回 的 啊 应 : 

HTTP/1.1 200 OK 


Date: Tue, 13 Jan 2015 16:11:58 GMT 
Content-Length: 37 


Content-Type: text/plain; charset=utf-8 


first_name=sausheong&last_name=chang 


因为 Go 语言 提供 了 诸如 FormValue 和 FormFile 这 样 的 方法 来 
提取 通过 POST 方法 提交 的 表单 ， 所 以 用 户 一 般 不 需要 自行 读 取 主体 中 
未 经 处 理 的 表单 ， 本 章 接 下 来 的 一 节 就 会 介绍 FormValue 和 


FormFile 等 方法 。 


4.2 ”Go 与 HTML 表单 


在 学 习 如 何 从 POST 请 求 中 获取 表单 数据 之 前 ， 让 我 们 先 来 了 解 一 
下 HTML 表 单 。 在 绝 大 多 数 情况 下 ，POST 请 求 都 是 通过 HTML 表 单 发 
送 的 ， 这 些 表 单 看 上 去 通常 会 是 下 面 这 个 样子 : 


<form action="/process" method="post"> 
<input type="text" name="first_name"/> 


<input type="text" name="last_name"/> 
<input type="submit"/> 
</form> 


<form> 标签 可 以 包围 文本 行 、 文 本 框 、 单 选 按钮 、 复 选 框 以 及 文 
件 上 传 等 多 种 HTML 表 单元 素 ， 而 用 户 则 可 以 把 想 要 传递 给 服务 大 的 数 
据 输 入 到 这 些 元 素 里 面 。 当 用 户 按 下 发 送 按 钮 、 又 或 者 通过 茶 种 方式 
触发 了 表单 的 发 送 操作 之 后 ， 用 户 在 表 持 中 输入 的 数据 束 会 被 发 送 至 
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用 户 在 表单 中 输入 的 数据 会 以 键 值 对 的 形式 记录 在 请 求 的 主体 
中 ， 然 后 以 HTTP POST 请 求 的 形式 发 送 人 至 服务 左 。 因 为 服务 瑚 在 接收 
到 浏 咒 器 发 送 的 表单 数据 之 后 ， 还 需要 对 这 些 数据 进行 语法 分 析 ， 从 
而 提取 出 数据 中 记录 的 键 值 对 ， 因 此 我 们 还 需要 知道 这 些 键 值 对 在 请 
求 主体 中 是 如 何 格式 化 的 。 


HTML 表 单 的 内 容 类 型 (content type) 决定 了 POST 请 求 在 发 送 键 
值 对 时 将 使 用 何 种 格式 ， 其 中 ，HTML 表 单 的 内 容 类 型 是 由 表单 的 
enctype 属性 指定 的 : 


<form action="/process" method="post" enctype="application/x-www- 
form-urlencoded"> 
<input type="text" name="first_name"/> 


<input type="text" name="last_name"/> 
<input type="submit"/> 
</form> 


enctype 属性 的 默认 值 为 application/x-www-form- 
urlencoded。 浏 览 器 至 少 需要 支持 application/x-www-form- 
urlencoded 和 multipart/form-data 这 两 种 编码 方式 。 除 以 上 
两 种 编码 方式 之 外 ，HTML5 还 支持 text/plain 编码 方式 。 


如 果 我 们 把 enctype 属性 的 值 设 置 为 application/x-www- 
form-urlencoded ， 那 么 浏览 如 将 把 HTML 表 单 中 的 数据 编码 为 一 
个 连续 的 “长 查询 字符 串 ” (long query string) : 在 这 个 字符 串 中 ， 不 同 
的 键 值 对 将 使 用 & 符号 分 隔 ， 而 键 值 对 中 的 键 和 值 则 使 用 等 号 = 分 隔 。 
这 种 编码 方式 跟 我 们 在 第 1 章 看 到 过 的 URL 编 码 是 一 样 的 ， 
application/x-www-form- urlencoded 编 码 名 字 中 的 urlencoded 
一 词 也 由 此 而 来 。 换 句 话 说 ,一 个 application/x- www- form- 
urlencoded 编码 的 HTTP 请 求 主体 看 上 去 将 会 是 下 面 这 个 样子 的 : 


first_name=sau%20sheong&last_name=chang 


但 是 ， 如 果 我 们 把 enctype 属性 的 值 设置 为 nultipart/form- 
data ， 那 么 表单 中 的 数据 将 被 转换 成 一 条 MIME 报 文 : 表单 中 的 每 个 
键 值 对 都 构成 了 这 条 报 文 的 一 部 分 ， 并 且 每 个 键 值 对 都 帝 有 它们 各 和 目 
的 内 容 类 型 以 及 内 容 配置 (disposition) 。 以 下 是 一 个 使 用 
multipart/form-data 编码 对 表单 数据 进行 格式 化 的 例子 : 


WebKitFormBoundaryMPNjKpeO9cLiocMw 
Content-Disposition: form-data; name="first_name" 


sau sheong 
WebKitFormBoundaryMPNjKpeO9cLiocMw 


Content-Disposition: form-data; name="last name" 


WebKitFormBoundaryMPNjKpeO9cLiocMw-- 


既然 表单 同时 支持 application/x-www-form-urlencoded 
编码 和 multipart/form-data 编码 ， 那 么 我 们 该 选择 使 用 哪 种 编码 


WE? 答案 征 ， 如 有 果 表 单传 送 的 生 商 单 的 文本 数据 ， 那 么 使 用 URL 编 码 
格式 更 好 ， 因 为 这 种 编码 更 为 简单 、 高 效 ， 并 且 它 所 需 的 计算 量 要 比 
男 一 种 编码 少 。 但 是 ， 如 采 表 单 需 要 传送 大 量 数据 “如 上 传 文件 ) 那 
么 使 用 multipart /form- data 编 码 格式 会 更 好 一 些 。 在 需要 的 情况 
下 ， 用 户 还 可 以 通过 Base64 编 码 ， 以 文本 方式 传送 二 进 制 数据 。 


到 目前 为 止 ， 我 们 只 讨论 了 如 何 通过 POST 请 求 发 送 表 单 ， 但 实际 
上 通过 GET 请 求 也 是 可 以 发 送 表 单 的 一 一 因为 HTML 表 单 的 method JE 
性 的 值 既 可 以 是 POST 也 可 以 是 GET ， 所 以 下 面 这 个 HTML 表 单 也 是 合 
法 的 : 


<form action="/process" method="get"> 
<input type="text" name="first_name"/> 
<input type="text" name="last_name"/> 


<input type="submit"/> 
</form> 


因为 GET 请 求 并 不 包含 请 求 主体 ， 所 以 在 使 用 GET 方法 传递 表单 
时 ， 表 单数 据 将 以 键 值 对 的 形式 包含 在 请 求 的 URL 里 面 ， 而 不 是 通过 
主体 传递 。 


在 了 解 了 HTML 表 单 癌 服务 闫 传递 数据 的 方法 之 后 ， 让 我 们 回 到 服 
务 器 一 端 ， 学 习 一 下 如 何 使 用 net/http 库 来 处 理 这 些 表单 数据 。 


4.2.1 Form 


上 一 市 曾经 提 人 到 过 ， 为 了 提取 表单 传递 的 键 值 对 数据 ， 用 户 可 能 
需要 亲自 对 服务 器 接收 到 的 未 经 处 理 的 表单 数据 进行 语法 分 析 。 但 事 


SE, AAnet/http 库 已 经 提供 了 一 套用 途 相 当 广 沁 的 函数 ， 这 些 
函数 一 般 都 能 够 满足 用 户 对 数据 提取 方面 的 需求 ， 所 以 我 们 很 少 需要 
目 行 对 表单 数据 进行 语法 分 析 。 


通过 调用 Request 结构 提供 的 方法 ， 用 户 可 以 将 URL、 主 体 又 或 
者 以 上 两 者 记录 的 数据 提取 到 该 结构 的 Form 、PostForm 和 
MultipartForm 等 字段 当中 。 跟 我 们 平常 通过 POST 请 求 获取 到 的 数 
据 一 样 ， 存 储 在 这 些 字段 里 面 的 数据 也 是 以 键 值 对 形式 表示 的 。 使 用 
Request 结构 的 方法 获取 表单 数据 的 一 般 步 又 是 : 


(1) 调用 ParseFornm 方法 或 者 ParseMultipartForm 方法 ， 
对 请 求 进行 语法 分 析 。 
(2) 根据 步 又 1 调用 的 方法 ， 访 问 相 应 的 Form 字段 、PostForm 


字段 或 MultipartForm 字段 。 


代码 清单 4-4 展 示 了 一 个 使 用 ParseForm 方法 对 表单 进行 语法 分 
析 的 例子 。 


代码 清单 4.4 ”对 表单 进行 语法 分 析 


package main 


import ( 
" fmt UL! 
"net/http" 
) 


func process(w http.Responsewriter, r *http.Request) { 
r.ParseForm( ) 
fmt. Fprintln(w, r.Form) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


这 段 代码 中 最 重要 的 束 古 下 面 这 两 行 : 


r.ParseForm() 
fmt.Fprintln(w, r.Form) 


如 前 所 述 ， 这 段 代 码 首先 使 用 了 ParseForm 方法 对 请 求 进行 语法 
分 机 ， 然 后 再 访问 Form 字段 ， 获 取 具 体 的 表单 。 


现在 ， 让 我 们 来 创建 一 个 短小 精 悍 的 HTML 表 单 ， 并 使 用 它 作 为 客 
户 病 ， 回 代码 清单 4-4 所 示 的 服务 器 发 送 请 求 。 请 创建 一 个 名 为 
client .html 的 文件 ， 并 将 以 下 代码 复制 到 该 文件 中 : 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8" /> 
<title>GowebProgramming</title> 
</head> 
<body> 
<form action=http://127.0.0.1:8080/process? 


hello=world&thread=123 


=method="post" enctype="application/x-www-form-urlencoded"> 
<input type="text" name="hello" value="sau sheong"/> 
<input type="text" name="post" value="456"/> 
<input type="sSubmit"/> 
</form> 
</body> 
</html> 


这 个 HITML 表 单 可 以 完成 以 下 工作 : 


通过 POST 方法 将 表单 发 送 至 地 址 http://localhost:8080/process? 
hello=world&thread=123; 

通过 enctype 属性 将 表单 的 内 容 类 型 设置 为 application/x- 
www-form-urlencoded; 

将 hello=sau sheong 和 post=456 这 两 个 HTML 表 单 键 值 对 
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需要 注意 的 是 ， 这 个 表单 为 相同 的 键 he1L1o 提供 了 两 个 不 同 的 
值 ， 其 中 ， 值 wor1d 是 通过 URL 提 供 的 ， 而 值 sau sheong 则 是 通过 
HTML 表 单 中 的 文本 输入 行 提供 的 。 


因为 客户 端 可 以 直接 在 浏览 器 上 运行 ， 所 以 我 们 并 不 需要 使 用 服 
BERNER Moe ARS: 我 们 要 做 的 吏 是 使 用 浏览 万 打 开 
client html 文件， 然后 点 击 表 单 中 的 发 送 按 钮 。 如 采 一 切 正 汕 ， 训 
览 硕 应 该 会 显示 以 下 输出 : 


map[thread: [123] hello:[sau sheong world] post:[456]] 


这 是 服务 器 在 对 请 求 进 行 语 法 分 析 之 后 ， 使 用 字符 串 形 式 显 示 出 
来 的 未 经 处 理 的 Form 结构 。 这 个 结构 是 一 个 映射 ， 它 的 键 是 字符 串 ， 
而 键 的 值 是 一 个 由 字符 串 组 成 的 切片 。 因 为 映射 是 无 序 的 ， 所 以 你 看 
到 的 键 值 对 排列 顺序 可 能 和 这 里 展示 的 有 所 不 同 。 但 是 无 论 如 何 ， 这 
个 映射 总 是 会 包含 查询 值 hello=world 和 thread=123 ， 还 有 表单 
值 hello=sau sheong 和 post=456。 正 如 所 见 ， 这 些 值 都 进行 了 


相应 的 URL 解 码 ， 比 如 在 sau 和 sheong 之 间 就 能 够 正常 地 看 到 空 
格 ， 而 不 是 编码 之 后 的 %20 。 


4.2.2 PostForm 字 上 段 


对 上 一 下 提 到 的 post 这 种 只 会 出 现在 表单 或 者 URL 两 者 其 中 一 个 
地 方 的 键 来 说 ， 执 行 语句 r ,Form["post"] 将 返回 一 个 切片 ， 切 片 里 
面包 含 了 这 个 键 的 表单 值 或 者 URL 值 ， 就 像 这 样 : [456] 。 而 对 
hello 这 种 同时 出 现在 表单 和 URL 两 个 地 方 的 键 来 说 ， 执 行 语句 
r.Form["hello"] 将 返回 一 个 同时 包含 了 键 的 表单 值 和 URL 值 的 切 
片 ， 并 且 表 单 值 在 切片 中 总 是 排 在 URL 值 的 前 面 ， 就 像 这 样 : [sau 


sheong world] ° 


如 果 一 个 键 同 时 拥有 表单 键 值 对 和 URIL 键 值 对 ， 但 是 用 户 只 想 要 
获取 表单 键 值 对 而 不 是 URL 键 值 对 ， 那 么 可 以 访问 Request 结构 的 
PostForm 字段 ， 这 个 字段 只 会 包含 键 的 表单 值 ， 而 不 包含 任何 同名 
键 的 URL 值 。 举 个 例子 ， 如 有 果 我 们 把 前 面 代码 中 的 r.Form 语句 改 为 
r.PostForm 语句 ， 那 么 程序 将 打印 出 以 下 结 


map[post:[456] hello:[sau sheong] ] 


上 面 这 个 输出 使 用 的 是 application/x-www-form- 
urlencoded 内 容 类 型 ， 如 果 我 们 修改 一 下 客户 端的 HTML 表 单 ， 计 
它 使 用 multipart/form-data 作为 内 容 类 型 ， 并 对 服务 器 代码 进行 
调整 ， 让 它 重 新 使 用 r . Form 语句 而 不 是 r .PostForm 语句 ， 那 么 程 
序 将 打印 出 以 下 结 


map[hello: [world] thread: [123] ] 


因为 PostForm 字段 只 文 持 application/x-www-form- 
urlencoded 编码 ， 所 以 现在 的 r .Form 语句 将 不 再 返回 任何 表单 
值 ， 而 是 只 返回 URL 查 询 值 。 为 了 解决 这 个 问题 ， 我 们 需要 通过 
MultipartForm 字段 来 获取 multipart/form-data 编码 的 表单 数 
据 。 


4.2.3 MultipartForm Zf& 


为 了 取得 multipart/form-data 编码 的 表单 数据 ， 我 们 需要 用 
到 Request 结构 的 ParseMultipartForm 方法 和 Mu1lLtipartForm 
字段 ， 而 不 再 使 用 ParseFornm 方法 和 Form 字段 ， 不 过 
ParseMultipartForm 方法 在 需要 时 也 会 自行 调用 ParseForm 方 
法 。 现 在 ， 我 们 需要 修改 代码 清单 4-4 中 展示 的 服务 器 程序 ， 把 原来 的 
ParseForm 方法 调用 以 及 打印 语句 替换 成 以 下 两 条 语句 : 


r.ParseMultipartForm(1024) 


fmt.Fprintln(w, r.MultipartForm) 


这 里 的 第 一 行 代码 说 明了 我 们 想 要 从 multipart 编 码 的 表单 里 面 取出 
多 少 字 市 的 数据 ， 而 第 二 行 语句 则 会 打印 请 求 的 MultipartForm 字 
段 。 修 改 后 的 服务 絮 在 执行 时 将 打印 以 下 结果 : 


&{map[hello:[sau sheong] post:[456]] map[]} 


因为 MultipartForm 字段 只 包含 表单 键 值 对 而 不 包含 URL 键 值 
对 ， 所 以 这 次 打印 出 来 的 只 有 表单 键 值 对 而 没有 URL 键 值 对 。 另 外 需 
要 注意 的 是 ，MultipartForm 字段 的 值 也 不 再 是 一 个 映射 ， 而 是 一 
个 包含 了 两 个 映射 的 结构 ， 其 中 第 一 个 映射 的 键 为 字符 串 ， 值 为 字符 
串 组 成 的 切片 ， 而 第 二 个 映射 则 是 空 的 一 一 这 个 映射 之 所 以 会 为 空 ， 
是 因为 它 是 用 来 记录 用 户 上 传 的 文件 的 ， 关 于 这 个 映射 的 具体 信息 我 
们 将 会 在 接 下 来 的 一 节 看 到 。 


除了 上 面 提 到 的 几 个 方法 之 外 ，Request 结构 还 提供 了 另外 一 些 
方法 ， 它 们 可 以 让 用 户 更 容易 地 获取 表单 中 的 键 值 对 。 其 中 ， 
FormValue 方法 允许 直接 访问 与 给 定 键 相 关联 的 值 ， 就 像 访问 Form 
字段 中 的 键 值 对 一 样 ， 唯 一 的 区 别 在 于 : 因为 FormValue 方法 在 需要 
时 会 自动 调用 ParseForm 方法 或 者 ParseMultipartForm 方 法， 所 
以 用 户 在 执行 FormValue 方法 之 前 ,不 需要 手动 调用 上 面 提 到 的 两 个 


语法 分 析 方法 。 


这 意味 着 ， 如 果 我 们 把 以 下 语句 写 到 代码 清单 4-4 所 示 的 服务 器 程 


fmt.Fprintln(w,r.FormValue( "hello")) 


| 
Ba 


并 将 客户 端 表 单 的 enctype 属性 的 值 设置 为 application/x-www- 
form-urlencoded ， 那 么 服务 器 将 打印 出 以 下 结 采 : 


sau sheong 


因为 FormValue 方法 即使 在 给 定 键 拥有 多 个 值 的 情况 下 ， 也 只 会 
从 Form 结构 中 取出 给 定 键 的 第 一 个 值 ， 所 以 如 果 想 要 获取 给 定 键 包 售 
的 所 有 值 ， 那 么 就 需要 直接 访问 Form 结构 : 


fmt.Forintln(w, r.FormValue("hello") ) 


fmt.Fprintln(w, r.Form) 


上 面 这 两 条 语句 将 产生 以 下 输出 : 


sau sheong 


map[post: 1456] hello:[sau sheong world] thread: [123] ] 


除了 访问 的 是 PostForm 字段 而 不 是 Form 字段 之 外 ， 
PostFormValue 方法 的 作用 跟 上 面 介 绍 的 FormValue 方法 的 作用 基 
本 相同 。 下 面 是 一 个 使 用 PostFormValue 方法 的 例子 : 


fmt.Fprintln(w, r.PostFormValue("hello") ) 


fmt.Fprintln(w, r.PostForm) 


P TED 3 PN FT ESA D R: 


sau sheong 


map[hello:[sau sheong] post:[456] ] 


正如 结果 所 示 ，PostFormValue 方法 只 会 返回 表单 键 值 对 而 不 
会 返回 URL 键 值 对 。 


FormValue 方法 和 PostFormValue 方法 都 会 在 需要 时 自动 去 调 
用 ParseMultipartForm 方法 ， 因 此 用 户 并 不 需要 手动 调用 
ParseMultipartForm 方法 ， 但 这 里 也 有 一 个 需要 注意 的 地 方 (至 
少 对 于 Go 1.4 版 本 来 说 ) : 如 果 你 将 表单 的 enctype 设置 成 了 
multipart/form-data ， 然 后 笑 试 通过 FormValue 方法 或 者 
PostFormValue 方法 来 获取 键 的 值 ， 那 么 即使 这 两 个 方法 调用 了 
ParseMultipartForm 方法 ， 你 也 不 会 得 到 任何 结 


为 了 验证 这 一 点 ， 让 我 们 再 次 修改 服务 句 程 序 ， 给 它 加 上 以 下 代 


.Fprintln(w, "(1) .FormValue("hello") ) 
.Fprintin(w, .PostFormValue("hello") ) 


.Fprintin(w, .PostForm) 
.Fprintin(w, .MultipartForm) 


以 下 是 在 表单 的 enctype Amultipart/form-data 的 情况 
下 ， 服 务 硕 打印 出 的 结果 : 


1) world 


ma 


på] 
&{map[hello:[sau sheong] post:[456]] map[]} 


结果 中 的 第 一 行 返回 的 是 键 hello 的 值 ， 并 且 这 个 值 来 自 URL 而 
不 是 表单 。 至 于 结果 中 的 第 二 行 和 第 三 行 ， 则 证 明了 前 面 提 到 的 “使 用 
PostFormValue 方法 不 会 得 到 任何 值 ”这 一 说 法 ， 而 PostForm 字段 
为 空 则 是 引发 这 一 现象 的 菲 魁 祸首 。PostForm 字段 之 所 以 会 为 空 ， 


是 因为 FormValue 方法 和 PostFormValue 方法 分 别 对 应 Form 字段 
和 PostForm 字段 ， 而 表单 在 使 用 multipart/form-data 编码 时 ， 
表单 数据 将 被 存储 到 MultipartForm 字段 而 不 是 以 上 两 个 字段 中 。 
结果 的 最 后 一 行 证 明 ParseMultipartForm 方法 的 确 被 调用 了 一 一 
用 户 只 要 访问 MultipartForm 字段 ， 就 可 以 取得 所 有 表单 值 。 


KEA T Request 结构 的 很 多 相关 字段 以 及 方法 ， 表 4-1 对 它们 
进行 了 回顾 ， 并 阐述 了 各 个 方法 之 间 的 区 别 。 除 此 之 外 ， 这 个 表 还 说 
明了 调用 哪个 方法 可 以 取得 哪个 字段 的 值 ， 并 阐述 了 这 些 值 的 来 源 以 
及 这 些 值 的 类 型 。 比 如 ， 表 的 第 一 行 就 说 明了 ， 通 过 以 直接 或 间接 的 
方式 调用 ParseForm 方法 ， 用 户 可 以 将 数据 存储 到 Form FREH, 
然后 用 户 只 要 访问 Form 字段 ， 就 可 以 取得 编码 类 型 为 
application/x-www-form-urlencoded 的 URL 数 据 和 表单 数 
据 。 对 表 4-1 中 列 出 的 字段 以 及 方法 来 说 ， 它 们 唯一 令 人 感到 遗憾 的 地 

方 就 是 ， 这 些 字 段 以 及 方法 的 命名 规范 并 不 是 特别 让 人 满意 ， 还 有 很 
多 有 竺 改善 的 地 方 。 


表 4-1 对 比 Form、PostForm #lMultipartForm 字段 


键 值 对 的 来 源 内 容 类 型 
字段 需要 调用 的 方法 或 
需要 访问 的 字段 
URL | 表单 | URLS | Multipart 编 码 


kl il bb 
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MultipartForm | ParseMultipartForm 方法 | 一 v — v 


pee fe Je fe Eoo 


_ ee 


4.2.4 文件 


multipart/form-data 编码 通常 用 于 实现 文件 上 传 功能 ， 这 种 
功能 需要 用 到 file 类 型 的 jnput 标签 。 代 码 清单 4-5 给 出 的 就 是 之 前 
展示 过 的 客户 端 表单 在 实现 了 文件 上 传 功能 之 后 的 样子 ， 其 中 以 加 粗 
方式 呈现 的 是 新 增 或 者 经 过 修改 的 代码 。 


代码 清单 4-5 文件 上 传 


< html> 
< head> 


< meta http-equiv="Content-Type" content="text/html; 
charset=utf-8" /> 
< title>Go Web Programming< /title> 
< /head> 
< body> 
< form action="http://localhost :8080/process? 
hello=world&thread=123" 
method="post" enctype="multipart/form-data"> 


< input type="text" name="hello" value="sSau sheong"/> 
< input type="text" name="post" value="456"/> 
< input type="file" name="uploaded"> 


< input type="submit"> 
< /form> 
< /body> 


< /html> 
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改 ， 具 体 见 代码 清单 4-6。 


代码 清单 4-6 ”通过 MultipartForm 字段 接收 用 户 上 传 的 文件 


package main 


import ( 
UL! fmt UL! 
"io/ioutil" 
"net/http" 
) 


func process(w http.Responsewriter, r *http.Request) { 

r.ParseMultipartForm(1024) 
fileHeader := r.MultipartForm.File["uploaded"][0] 
file, err := fileHeader .Open( ) 
if err == nil { 

data, err := ioutil.ReadAll(file) 

if err == nil { 

fmt.Fprintin(w, string(data) ) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


正如 之 前 所 说 ， 服 务 器 在 处 理 文件 上 传 时 首先 要 做 的 就 是 执行 
ParseMultipartForm 方法 ， 接 看 从 MultipartForm 字段 的 File 
字段 里 面 取出 文件 头 FileHeader ， 然 后 通过 调用 文件 头 的 0pen 方 
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组 中 ， 并 将 这 个 字 市 数组 的 内 容 打 印 出 来 。 现 在 ， 如 来 我 们 向 服务 器 
上 传 一 个 纯 文本 文件 ， 那 么 服务 占 将 把 这 个 文件 的 内 容 打印 在 浏览 吉 
‘Pes 


跟 FormValue 方法 和 PostFormValue FERM, net/http Æ 
也 提供 了 一 个 FormFile 方法 ， 它 可 以 快速 地 获取 被 上 传 的 文件 : 
FormFile 方法 在 被 调用 时 将 返回 给 定 键 的 第 一 个 值 ， 因 此 它 在 客户 
端 只 上 传 了 一 个 文件 的 情况 下 ， 使 用 起 来 会 非常 方便 。 代 码 清单 4-7 展 
示 了 一 个 使 用 FormFile 方法 的 例子 。 


代码 清单 4-7 使 用 FormFile 方法 获取 被 上 传 的 文件 


func process(w http.Responsewriter, r *http.Request) { 
file, _, err := r.FormFile("uploaded" ) 
if err == nil { 
data, err := ioutil.ReadAll(file) 
if err == nil { 


fmt.Fprintin(w, string(data) ) 


正如 代码 所 示 ，FormFile 方法 将 同时 返回 文件 和 文件 头 作 为 结 
果 。 用 户 在 使 用 FormFile 方法 时 ， 将 不 再 需要 手动 调用 
ParseMultipartForm 方法 ， 只 需要 对 返回 的 文件 进行 处 理 即 可 。 


4.2.5 ”处理 带 有 JSON 主 体 的 POST 请 求 


因为 前 面 的 内 容 一 直 只 使 用 HTML 表 单 发 送 POST 请 求 ， 所 以 到 目 
前 为 止 ， 我 们 考虑 的 都 是 如 何 处 理 请 求 主体 中 的 键 值 对 。 但 实际 上 ， 


POST 请 求 并 不 是 只 能 通过 HTML 表 单 发 送 : 诸如 jQuery 这 样 的 客户 端 
库 ， 义 或 者 是 Angular、Ember 这 样 的 客户 问 框 架 ， 其 至 是 Adobe 
Flash ` Microsoft Silverlight 这 样 的 技术 ， 都 能 够 发 送 POST 请 求 ， 并 且 
这 种 行为 正在 变 得 越 来 越 浓 见 。 


需要 注意 的 是 ， 使 用 ParseForm 方法 是 无 法 从 Angular 客 户 端 发 
送 的 POST 请 求 中 获取 JSON 数 据 的 ， 但 使 用 jQuery 这 样 的 JavaScript 库 却 
不 会 出 现 这 样 的 问题 。 


造成 这 一 区 别 的 原因 在 于 ， 不 同 客户 端 使 用 了 不 同 的 方式 编码 
POST 请 求 : jQuery 会 像 HTML 表 单一 样 ， 使 用 application/x-www- 
form-urlencoded 对 POST 请 求 进行 编码 (具体 做 法 是 ，jQuery 会 把 
POST 请 求 的 Content -Type 首部 的 值 设置 为 application/x-www- 
form-urlencoded ) ， 而 Angular 在 编码 POST 请 求 时 使 用 的 却 是 
application/json。 因 为 Go 语言 的 ParseForm 方法 只 会 对 表单 数 
据 进 行 语法 分 析 ， 它 并 不 接受 application/json 编码 ， 所 以 使 用 这 
一 编码 发 送 POST 请 求 的 用 户 目 然 也 无 法 通过 ParseForm 方法 获得 任 
何 数据 。 


这 个 问题 跟 库 的 实现 无 和 天， 真正 的 徘 技 祸首 实际 上 是 没有 尼 够 的 
文档 对 这 种 行为 进行 说 明 ， 而 程序 员 叉 对 他 们 使 用 的 框架 做 了 某 种 假 
设 ， 这 样 一 来 ， 问 题目 然而 然 地 也 束 出 现 了 。 


因为 框架 可 以 隐藏 复杂 性 和 实现 细节 ， 所 以 程序 员 应 该 使 用 框 
架 。 但 与 此 同时 ， 理 解 框 染 的 工作 方式 ， 了 解 框 架 如 何 化 脸 为 何 ， 也 


古 非 第 重要 的 。 否 则 ， 在 使 用 框架 与 其 他 程序 进行 对 接 的 时 候 ， 就 可 
能 会 出 现 各 种 各 样 的 问题 。 


到 目前 为 止 ， 本 章 已 经 对 “如 何 处 理 请 求 " 这 一 问题 做 了 足够 多 的 
介绍 ， 现 在 ， 征 时 候 讲 讲 如 何 癌 用 户 发 送 啊 应 了 。 


4.3 ResponseWriter 


首先 创建 一 个 Response 结构 ， 接 着 将 数据 存储 到 这 个 结构 里 
面 ， 最 后 将 这 个 结构 返回 给 客户 端 A a 
方式 疝 客户 端 返回 响应 的 ， 那 么 你 就 错 了 : 服务 器 在 向 客户 端 返 回响 
应 的 时 候 ， 真 正 需 要 用 到 的 是 ResponseWriter 接口 。 


Responsewriter 是 一 个 接口 ， 处 理 器 可 以 通过 这 个 接口 创建 
HTTP 响 应 。Responsewriter 在 创建 响应 时 会 用 到 
http.response a 因为 该 结构 是 一 个 非 导 出 (nonexported) 的 

结构 ， 所 以 用 户 只 能 通过 Responsewriter 来 使 用 这 个 结构 ， 而 不 能 
直接 使 用 它 


I 为 什么 要 以 传 值 的 方式 将 ResponseWriter 传 递 给 ServeHTTP 


在 阅读 了 本 章 前 面 的 内 容 之 后 ， 有 的 读者 可 能 会 感到 疑惑 


ServeHTTP 为 什么 要 接 ， 
受 Responsewriter 接口 和 一 个 指向 Request 结构 的 指针 作为 参数 呢 ? 接受 Request 结 


构 指针 的 原因 很 简单 : 为 了 让 服务 器 能 够 察觉 到 处 理 器 对 Request 结构 的 修改 ， 我 们 必须 | 
以 传 引用 (pass by reference) 而 不 是 传 值 (pass by value) 的 方式 传递 Request 结构 。 但 是 . 


男 一 方面 ， 为 什么 ServeHTTP 却 是 以 传 值 的 方式 接受 ResponseWriter VE? 难道 服务 器 不 
需要 知道 处 理 器 对 Responsewriter 所 做 的 修改 吗 ? | 


对 于 这 个 问题 ， 如 果 我 们 深入 探究 net/http 库 的 源码 ， 就 会 发 现 Responsewriter : 
实际 上 就 是 response 这 个 非 导 出 结构 的 接口 ， 而 Responsewriter 在 使 用 response 44 | 
构 时 ， 传 递 的 也 是 指向 response 结构 的 指针 ， 这 也 就 是 说 ，Responsewriter 是 以 传 引 | 
而 不 是 传 值 的 方式 在 使 用 response 结构 。 : 


换 句 话说， 实际 上 ServeHTTP 函数 的 两 个 参数 传递 的 都 是 引用 而 不 是 值 一 一 虽然 
Responsewriter 看 上 去 像 是 一 个 值 ， 但 它 实际 上 却 是 一 个 高 有 结构 指针 的 接口 。 


Responsewriter 接口 拥有 以 下 3 个 方法 : 


e Write; 
e WriteHeader ; 


e Header ° 


对 ResponseWriter 进 行 写 入 


Write 方法 接受 一 个 字 市 数组 作为 参数 ， 并 将 数组 中 的 子 市 写 入 
HITTP 员 应 的 主体 中 。 如 于 用户 在 使 用 write 方法 执行 写 入 操作 的 时 
候 ， 没 有 为 首部 设置 相应 的 内 容 类 型 ， 那 么 啊 应 的 内 容 类 型 将 通过 检 
测 被 写 入 的 前 512 字 节 决 定 。 代 码 清单 4-8 展 示 了 Write 方法 的 用 法 。 


代码 清单 4-8 使 用 write 方法 向 客户 端 发 送 响应 


package main 


import ( 
"net/http" 
) 


func writeExample(w http.Responsewriter, r *http.Request) { 
str := "<html> 

<head><title>Go Web Programming</title></head> 

<body><hi>Hello World</h1></body> 

</html>" 


w.Write([]byte(str) ) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/write", writeExample) 
server .ListenAndServe( ) 


} 


这 段 代码 通过 调用 Write 方法 将 一 段 HTML 字 人 符 串 写 入 了 HTTP 员 
应 的 主体 中 。 通 过 向 服务 器 发 送 以 下 命令 : 


curl -i 127.0.0.1:8080/write 


我 们 可 以 得 到 以 下 了 响应 : 


HTTP/1.1 200 OK 

Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 

Content-Type: text/html; charset=utf-8 


<html> 


<head><title>GoWebProgramming</title></head> 
<body><hi>Hello World</h1></body> 
</html> 


注意 ， 尽 管 我 们 没有 亲自 为 响应 设置 内 容 类 型 ， 但 程序 还 是 通过 
信 测 自动 设置 了 正确 的 内 容 类 型 。 


WriteHeader 方法 的 名 字 带 有 一 点 儿 误 导 性 质 ， 它 并 不 能 用 于 设 
置 响应 的 首部 (Header 方法 才 是 做 这 件 事 的 ) : WriteHeader 方法 
接受 一 个 代表 HTTP 响 应 状态 码 的 整数 作为 参数 ， 并 将 这 个 整数 用 作 


HTTPAR DY ERS; 在 调用 这 个 方法 之 后 ， 用 户 可 以 继续 对 
Responsewriter 进行 写 入 ， 但 是 不 能 对 响应 的 首部 做 任何 写 入 操 
作 。 如 果 用 户 在 调用 write 方法 之 前 没有 执行 过 WriteHeader 方 
法 ， 那 么 程序 默认 会 使 用 200 OK 作为 响应 的 状态 码 。 


WriteHeader 方法 在 返回 错误 状态 码 时 特别 有 用 : 如 采 你 定义 了 
一 个 API， 但 是 疝 未 为 其 编写 具体 的 实现 ， 那 么 当 客户 端 访 问 这 个 API 
的 时 候 ， 你 可 能 会 布 望 这 个 API 返 回 一 个 501 Not Implemented， 状 态 
码 ， 代 码 清单 4-9 通 过 添加 新 的 处 理 器 实现 了 这 一 需求 。 顺 带 一 提 ， 王 
万 别 忘 了 使 用 HandleFunc 方法 将 新 处 理 器 绑 定 到 
DefaultServeMux 多 路 复 用 器 里 面 ! 


代码 清单 4-9 通过 WriteHeader 方法 将 状态 码 写 入 到 响应 当 


package main 


import ( 
UL! fmt UL! 
"net/http" 
) 


func writeExample(w http.Responsewriter, r *http.Request) { 
str := "<html> 
<head><title>Go Web Programming</title></head> 
<body><hi>Hello World</h1></body> 
</html>" 
w.Write([]byte(str) ) 


func writeHeaderExample(w http.ResponsewWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintln(w, "No such service, try next door") 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 

http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
server .ListenAndServe( ) 


通过 cURL 访 问 刚刚 添加 的 新 处 理 亏 : 


curl -i 127.0.0.1:8080/writeheader 


我 们 将 得 到 以 下 啊 应 : 


HTTP/1.1 501 Not Implemented 

Date: Tue, 13 Jan 2015 16:20:29 GMT 
Content-Length: 31 

Content-Type: text/plain; charset=utf-8 


No such service, try next door 


最 后 ， 通 过 调用 Header 方法 可 以 取得 一 个 由 首部 组 成 的 映射 (K 
于 首部 的 具体 细节 在 4.1.3 下 曾经 讲 过 ) ， 修 改 这 个 映射 就 可 以 修改 首 
部 ， 修 改 后 的 首部 将 被 包含 在 HITP 响 应 里 面 ， 并 随 着 响应 一 同 发 送 至 
客户 端 。 


代码 清单 4-10 ”通过 编写 首部 实现 客户 端 重 定 问 


aT 


package main 


import ( 
" fmt UL! 
"net/http" 
) 


func writeExample(w http.Responsewriter, r *http.Request) { 
str := "<html> 


<head><title>Go Web Programming</title></head> 
<body><hi>Hello World</h1></body> 
</html>" 

w.Write([]byte(str) ) 


func writeHeaderExample(w http.ResponsewWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintin(w, "No such service, try next door") 


} 


func headerExample(w http.ResponsewWriter, r ”http.Request) { 
w.Header().Set("Location", "http://google.com") 
w.WriteHeader (302) 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 

server .ListenAndServe( ) 


代码 清单 4-10 回 我 们 展示 了 如 何 实现 一 次 HTTP 重 定向 : 除了 将 状 
态 码 设置 成 了 302 之 外 ， 它 还 给 啊 应 添加 了 一 个 名 为 Location 的 首 
部 ， 并 将 这 个 首部 的 值 设置 成 了 重 定向 的 目的 地 。 需 要 注意 的 是 ， 


Wr iteHeader 方法 在 执行 完毕 之 后 就 不 允许 再 对 首部 进行 写 入 了 ， 
所 以 用 户 必 须 先 写 入 Location 首部 ， 然 后 再 写 入 状态 码 。 现 在 ， 如 
果 我 们 在 浏览 器 里 面 访问 这 个 处 理 器 ， 那 么 浏览 器 将 被 重 定向 到 
Google ° 


TTT, WRR AA CURL [AIX PS hae : 


curl -i 127.0.0.1:8080/redirect 


那么 cURL 将 获得 以 下 响应 : 


HTTP/1.1 302 Found 
Location: http://google.com 


Date: Tue, 13 Jan 2015 16:22:16 GMT 
Content-Length: 0 
Content-Type: text/plain; charset=utf-8 


最 后 ， 让 我 们 来 学 习 一 下 通过 Responsewriter 直接 向 客户 端 返 
回 JSON 数 据 的 方法 。 代 码 清单 4-11 展 示 了 如 何以 JSON 格 式 将 一 个 名 为 
Post 的 结构 返回 给 客户 端 。 


代码 清单 4-11 编写 JSON 输 出 


package main 


import ( 
UL! fmt UL! 
"encoding/json" 
"net/http" 

) 


type Post struct { 
User string 
Threads []string 


func writeExample(w http.Responsewriter, r *http.Request) { 
str := "<html> 
<head><title>Go Web Programming</title></head> 
<body><hi>Hello World</h1></body> 
</html>" 
w.Write([]byte(str) ) 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintin(w, "No such service, try next door") 


} 
func headerExample(w http.ResponsewWriter, r ”http.Request) { 


w.Header().Set("Location", "http://google.com") 
w.WriteHeader (302) 


func jsonExample(w http.Responsewriter, r *http.Request) { 
w.Header().Set("Content-Type", "application/json") 
post := &Post{ 
User: "Sau Sheong", 
Threads: []string{"first", "second", "third"}, 
} 
json, _ := json.Marshal(post) 
w.Write(json) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 
http.HandleFunc("/json", jsonExample) 

server .ListenAndServe( ) 


这 上段 代码 中 的 jsonExample 处 理 器 就 是 这 次 的 主角 。 因 为 本 书 将 
在 第 7 章 进一步 介绍 JSON 格 式 ， 所 以 不 了 解 JSON 格 式 的 读者 也 不 必 过 
于 担心 ， 目 前 来 说 ， 你 只 需要 知道 变量 json 是 一 个 由 Post 结构 序列 
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这 段 程 序 首先 使 用 Header 方法 将 内 容 类 型 设置 成 
application/json ， 然 后 调用 Write 方法 将 JSON 字 符 串 写 入 
Responsewriter 中 。 现 在 ， 如 果 我 们 执行 cURL 命令 : 


curl -i 127.0.0.1:8080/json 


那么 它 将 返回 以 下 了 响应 : 


HTTP/1.1 200 OK 

Content-Type: application/json 
Date: Tue, 13 Jan 2015 16:27:01 GMT 
Content-Length: 58 


{"User":"Sau Sheong", "Threads": ["first", "second", "third" ]} 


4.4 cookie 


本 书 在 第 2 章 曾 经 简单 地 介绍 过 如 何 使 用 cookie 创 建 身 份 验证 会 
话 ， 本 市 将 在 前 文 的 基础 上 ， 更 加 深入 地 人 研究 cookie 的 使 用 方法 ， 并 把 
cookie 应 用 在 更 为 第 见 的 客户 端 持久 化 场景 中 ， 而 不 仅仅 用 它 创建 会 
话 。 


cookie 是 一 种 存储 在 客户 端的 、 体 积 较 小 的 信息 ， 这 些 信息 最 初 都 
是 由 服务 器 通过 HTTP 响 应 报 文 发 送 的 。 每 当 客 户 端 向 服务 器 发 送 一 个 
HTTP 请 求 时 ，cookie 都 会 随 春 请 求 被 一 同 发 送 至 服务 右 。cookie 的 设计 
本 意 是 要 克服 HITP 的 无 状态 性 ， 虽 然 cookie 并 不 是 完成 这 一 目的 的 唯 
一 方法 ， 但 它 却 是 最 常用 也 最 流行 的 方法 之 一 : 整个 计算 机 行业 的 收 
入 都 建立 在 cookie 机 制 之 上 ， 对 互联 网 广告 领域 来 说 ， 更 是 如 此 。 


cookie 的 种 类 有 很 多 ， 其 中 一 些 还 拥有 非常 有 趣 的 名 字 ， 如 超级 
cookie、 第 三 方 cookie 以 及 僵尸 cookie。 但 总 的 来 说 ， 大 多 数 cookie 都 可 
以 被 划分 为 会 话 cookie 和 持久 cookie 两 种 类 型 ， 而 其 他 类 型 的 cookie 通 
常 都 是 持久 cookie 的 变种 。 


4.4.1 Go 与 cookie 


cookie 在 Go 语言 里 面 用 Cookie 结构 表示 ， 这 个 结构 的 定义 如 代码 
清单 4-12 所 示 。 


代码 清单 4-12 Cookie 结构 的 定义 


type Cookie struct { 
Name string 
Value string 
Path string 
Domain string 
Expires time .Time 
RawExpires string 


MaxAge int 
Secure bool 
HttpOnly bool 

Raw string 
Unparsed  []string 


没有 设置 Expires 字段 的 cookie 通 常 称 为 会 话 cookie 或 者 临时 
cookie， 这 种 cookie 在 浏览 妖 天 闭 的 时 候 就 会 目 动 被 移 除 。 相 对 而 言 ， 
设置 了 Expires 字段 的 cookie 通 常 称 为 持久 cookie， 这 种 cookie 会 一 直 
存在 ， 直 到 指定 的 过 期 时 间 来 临 或 者 被 手动 删除 为 止 。 


Expires 字段 和 MaxAge 字段 都 可 以 用 于 设置 cookie 的 过 期 时 
间 ， 其 中 Expires 字段 用 于 明确 地 指定 cookie 应 该 在 什么 时 候 过 期 ， 
而 MaxAge 字段 则 指明 了 cookie 在 被 浏览 器 创建 出 来 之 后 能 够 存活 多 少 
秒 。 之 所 以 会 出 现 这 两 种 截然 不 同 的 过 期 时 间 设 置 方式 ， 是 因为 不 同 
浏 蜗 器 使 用 了 各 不 相同 的 cookie 实 现 机 制 ， 跟 Go 语言 本 身 的 设计 无 
K ° BRHTTP 1.1 中 废弃 了 Expires ， 推 荐 使 用 MaxAge 来 代替 
Expires ,但 几乎 所 有 浏览 妖 都 仍然 支持 Expires ; 而 且 ， 微 软 的 正 


6 > IE 7 和 IE 8 都 不 支持 MaxAge 。 为 了 让 cookie 在 所 有 浏览 器 上 都 能 够 
正常 地 运作 ， 一 个 实际 的 方法 是 只 使 用 Expires ， 或 者 同时 使 用 
Expires #ilMaxAge ° 


4.4.2 ”将 cookie 发 送 至 浏览 器 


Cookie 结构 的 String 方法 可 以 返回 一 个 经 过 序列 化 处 理 的 
cookie, Set-Cookie 响应 首部 的 值 就 是 由 这 些 序 列 化 之 后 的 
cookie 组 成 的 。 代 码 清单 4-13 展 示 了 如 何 使 用 String 方法 去 序列 化 
cookie， 以 及 如 何 将 这 些 序列 化 之 后 的 cookie 发 送 至 客户 端 。 


代码 清单 4-13” 辣 浏 览 器 发 送 cookie 


package main 


import ( 
"net/http" 
) 


func setCookie(w http.Responsewriter, r *http.Request) { 
c1 := http.Cookie{ 


Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 

} 

c2 := http.Cookie{ 
Name: "second_cookie", 
Value: "Manning Publications Co", 
HttpOnly: true, 

} 


w.Header().Set("Set-Cookie", c1.String()) 
w.Header().Add("Set-Cookie", c2.String()) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/set_cookie", setCookie) 


server .ListenAndServe( ) 
} 


这 上 段 代码 首先 使 用 Set 方法 添加 第 一 个 cookie， 然 后 再 使 用 Add 方 
ERIE — “cookie ° HIE, HAN thas HH VIE] 
http://127.0.0.1:8080/set_cookie， 如 果 一 切 正常 ， 你 将 在 浏览 器 的 Web 
Inspector (审查 器 ) 中 看 到 图 4-3 所 示 的 cookie。 (图 中 展示 的 是 Safari 
浏览 右 附 市 的 Web Inspector， 但 无 论 使 用 的 是 什么 浏览 右 ， 在 相应 工具 
中 看 到 的 cookie 和 这 里 展示 的 应 该 都 是 一 样 的 。) 


eee Web Inspector — 127.0.0.1 — set_cookie 
— 
xD x 1 11.1ms 
= 
Resources Timelines Debugger Console inspect 
< © Cookies 
<> set cookie — 127.0.0.1 Name Value Domain Path Expires Size HTTP Secure 
è Cookies — 127.0.0.1 second_cookie Manning Publication Co 127.0.0.1 / Session 358 v 
E Local Storage — 127.0.0.1 first cookie Go Web Programming 127.0.0.1 / Session 308 v 


E Session Storage 一 127.0.0.1 


图 4-3 ”使 用 Safari 浏 览 器 的 Web Inspector 查 看 之 前 设置 的 cookie 


除了 Set 方法 和 Add 方法 之 外 ，Go 语 言 还 提供 了 一 种 更 为 快捷 方 
便 的 cookie 设 置 方 法 ， 那 就 是 使 用 net/http 库 中 的 Setcookie 方 
法 。 作 为 例子 ， 代 码 清单 4-14 展 示 了 如 何 使 用 SetCookie 方法 实现 与 
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代码 清单 4-14 使 用 SetCookie 方法 设置 cookie 


func setCookie(w http.Responsewriter, r *http.Request) { 
c1 := http.Cookie{ 
Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


:= http.Cookief 

Name: "second cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


} 
http.SetCookie(w, &c1) 


http.SetCookie(w, &c2) 


这 两 种 cookie 设 置 方式 区 别 并 不 大 ， 唯 一 需要 注意 的 是 ， 在 使 用 
SetCookie 方法 设置 cookie 时 ， 传 递 给 方法 的 应 该 是 指 加 Cookie 结 
构 的 指针 ， 而 不 是 Cookie 结构 本 身 。 


4.4.3 ”从 浏览 器 获取 cookie 


在 学 习 了 如 何 将 cookie 存 储 到 客户 端 之 后 ， 现 在 让 我 们 来 看 看 如 何 
从 客户 端 获取 cookie， 代 码 清单 4-15 展 示 了 这 一 操作 的 具体 实现 方法 。 


代码 清单 4-15 ”从 请 求 的 首部 获取 cookie 


package main 


import ( 
UL! fmt UL! 
"net/http" 
) 


func setCookie(w http.Responsewriter, r *http.Request) < 
c1 := http.Cookie{ 
Name: "first_cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


:= http.Cookie{ 

Name: "second_cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 
} 


func getCookie(w http.Responsewriter, r *http.Request) { 
h := r.Header["Cookie"] 
fmt.Fprintln(w, h) 

} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/set_cookie", setCookie) 
http.HandleFunc("/get_cookie", getCookie) 
server .ListenAndServe( ) 


在 重新 编译 并 有 旦 重新 启动 这 个 服务 絮 之 后 ， 使 用 浏览 器 访问 
http://127.0.0.1:8080/get_cookie， 将 会 在 浏览 器 上 看 到 以 下 结果 : 


[first_cookie=Go Web Programming; second_cookie=Manning 


Publications Co] 


语句 r .Header["Cookie"] 返回 了 一 个 切片 ， 这 个 切 厂 包含 了 
一 个 字符 串 ， 而 这 个 字符 串 又 包含 了 客户 端 发 送 的 任意 多 个 cookie。 如 
果 用 户 想 要 取得 单独 的 键 值 对 格式 的 cookie， 就 需要 自行 对 
r.Header["Cookie"] 返回 的 字符 串 进 行 语法 分 析 。 不 过 Go 也 提供 
了 一 些 其 他 方法 ， 让 用 户 可 以 更 容易 地 获取 cookie， 代 码 清单 4-16 展 示 
了 这 一 点 。 


代码 清单 4-16 使 用 Cookie 方法 和 Cookie 方法 


package main 


import ( 
UL! fmt UL! 
"net/http" 
) 


func setCookie(w http.Responsewriter, r *http.Request) { 
c1 := http.Cookie{ 
Name: "first_cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


} 
c2 := http.Cookie{ 
Name: "second cookie", 
Value: "Manning Publications Co", 


HttpOnly: true, 


http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 


} 
func getCookie(w http.Responsewriter, r *http.Request) { 
c1, err := r.Cookie("first cookie") 
if err != nil { 
fmt.Fprintln(w, "Cannot get the first cookie") 
} 
cs := r.Cookies() 


fmt.Fprintln(w, c1) 
fmt.Fprintln(w, cs) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/set_cookie", setCookie) 
http.HandleFunc("/get_cookie", getCookie) 
server .ListenAndServe( ) 


Go 语言 为 Request 结构 提供 了 一 个 Cookie 方法 ， 正 如 代码 清单 
4-16 中 的 加 粗 行 所 示 ， 这 个 方法 可 以 获取 指定 名 字 的 cookie。 如 果 指 定 
的 cookie 不 存在 ， 那 么 方法 将 返回 一 个 错误 。 因 为 Cookie 方法 只 能 获 


取 单 个 cookie， 所 以 如 果 想 要 同时 获取 多 个 cookie， 就 需要 用 到 
Request 结构 的 Cookies 方法 : Cookies 方法 可 以 返回 一 个 包含 了 
所 有 cookie 的 切片 ， 这 个 切 厂 跟 访问 Header 字段 时 获取 的 切片 是 完全 
相同 的 。 在 重新 编译 并 且 重 新 启动 服务 器 之 后 ， 访 问 
http:/127.0.0.1:8080/get_cookie， 浏 览 器 将 显示 以 下 内 容 : 


first_cookie=Go Web Programming 
[first_cookie=Go Web Programming second_cookie=Manning Publications 


Co] 


因为 上 面 展 示 的 代码 在 设置 cookie 时 并 没有 为 这 些 cookie 设 置 相 应 
的 过 期 时 间 ， 所 以 它们 都 是 会 话 cookie。 为 了 证 明 这 一 点 ， 我 们 只 需要 
退出 并 重启 浏览 器 (注意 ， 不 要 只 关闭 浏 贤 器 的 标签 ,一定 要 完全 述 
出 浏览 器 才 可 以 ) ， 然 后 再 次 访问 http://127.0.0.1:8080/get_cookie， 就 
会 发 现 之 前 设置 的 cookie 已 经 消失 了 ° 


44.4 ”使 用 cookie 实 现 内 现 消 息 


本 书 的 第 2 章 曾 经 介绍 过 如 何 使 用 cookie 管 理 用 户 登 录 会 话 ， 在 对 
cookie 有 了 更 多 了 解 之 后 ， 现 在 是 时 候 来 考虑 一 下 怎样 把 cookie 应 用 到 
AMAT I S 


为 了 向 用 户 报 告 某 个 动作 的 执行 情况 ， 应 用 程序 有 时 候 会 向 用 户 
展示 一 条 人 简短 的 通知 消息 ， 比 如 说 ， 如 果 一 个 用 户 笠 试 在 论坛 上 发 表 
篇 帖子 ， 但 是 这 篇 帖子 因为 某 种 原因 而 发 表 失 败 了 ， 那 么 论坛 应 该 
回 这 个 用 户 展 示 一 条 帖子 发 布 失 败 的 消息 。 根 据 本 书 之 前 提 到 过 的 最 
小 惊讶 原则 ， 这 种 通知 消 忆 应 该 出 现在 用 户 当 前 所 在 的 页 面 ， 但 是 在 
通常 情况 下 ， 用 户 在 访问 这 个 页 面 时 却 不 应 该 看 到 这 样 的 消息 。 
此 ， 程 序 实际 上 要 做 的 是 在 某 个 条 件 被 满足 时 ， 才 在 页 面 上 显示 一 条 
临时 出 现 的 消 恩 ， 这 样 用 户 在 刷 狐 页 面 之 后 就 不 会 再 看 见 相 同 的 消 乱 
了 一 一 我 们 把 这 种 临时 出 现 的 消息 称 为 闪现 消息 (flash message) 。 
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储 在 页 面 刷新 时 就 会 被 移 除 的 会 话 cookie 里 面 ， 代 码 清单 4-17 展 示 了 如 
何 使 用 Go 语言 实现 这 一 方法 。 


代码 清单 4-17 使 用 Go 的 cookie 实 现 闪现 消息 


package main 


import ( 
"encoding/base64" 
UL! fmt " 
"net/http" 
UL! time" 


) 


func setMessage(w http.Responsewriter, r *http.Request) { 
msg := []byte("Hello World!") 
c := http.Cookie{ 
Name: "flash", 


Value: base64.URLEncoding.EncodeToString(msg), 


} 
http.SetCookie(w, &c) 
} 
func showMessage(w http.Responsewriter, r *http.Request) { 
c, err := r.Cookie("flash") 
if err != nil { 
if err == http.ErrNoCookie { 
fmt.Fprintln(w, "No message found") 
} 
} else { 
rc := http.Cookie{ 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, 0), 
} 
http.SetCookie(w, &rc) 
val, _ := base64.URLEncoding.DecodeString(c.Value) 
fmt.Forintln(w, string(val) ) 
} 
} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set_message", setMessage) 
http.HandleFunc('"/show_message", showMessage) 
server .ListenAndServe( ) 
} 


这 段 代码 创建 了 setMessage 和 showMessage 两 个 处 理 器 函 
数 ， 并 分 别 把 它们 与 路 径 /set_message 以 及 /show_message 进行 


绑 定 。 首 先 ， 让 我 们 来 看 看 setMessage 函数 ， 它 的 定义 非常 简单 直 
接 ， 如 代码 清单 4 一 18 所 示 。 


代码 清单 4-18 ”设置 消息 


func setMessage(w http.Responsewriter, r *http.Request) { 
msg := []byte("Hello World!") 


c := http.Cookie{ 
Name: "flash", 
Value: base64.URLEncoding.EncodeToString(msg), 


} 
http.SetCookie(w, &c) 


setMessage 处 理 器 函数 的 定义 跟 之 前 展示 过 的 sSetCookie 处 
理 器 函数 的 定义 非常 相似 ， 主 要 的 区 别 在 于 setMessage 对 消息 使 用 
了 Base64URL 编 码 ， 以 此 来 满足 响应 首部 对 cookie 值 的 URL 编 码 要 求 。 
在 设置 cookieH 上 时， 如 有 果 cookie 的 值 没 有 包含 诸如 空格 或 者 百 分 号 这 样 的 
特殊 字符 ， 那 么 不 对 它 进 行 编码 也 是 可 以 的 ;但 是 因为 在 发 送 内 现 消 
息 时 ， 消 息 本 吴 通 常会 包含 诸如 空格 这 样 的 字符 ， 所 以 对 cookie 的 值 进 
行 编码 就 成 了 一 件 必 不 可 少 的 事情 了 。 


现在 再 来 看 看 showMessage 函数 的 定义 : 


func showMessage(w http.Responsewriter, r *http.Request) { 
c, err := r.Cookie("flash") 
if err != nil { 
if err == http.ErrNoCookie { 
fmt.Fprintln(w, "No message found") 


} 
} else { 
rc := http.Cookie{ 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, 0), 


} 

http.SetCookie(w, &rc) 

val, _ := base64.URLEncoding.DecodeString(c.Value) 
fmt.Fprintln(w, string(val) ) 


这 个 函数 百 先 会 答 试 获取 指定 的 cookie， 如 果 没 有 找到 该 cookie， 
它 就 会 把 变量 err 设置 成 一 个 http.ErrNoCookie 值 ， 并 向 浏览 器 
返回 一 条 “No message found” 消息 。 如 果 找 到 了 这 个 cookie， 那 么 它 必 
须 完成 以 下 两 个 操作 : 


(1) 创建 一 个 同名 的 cookie， 将 它 的 MaxAge 值 设 置 为 负数 ， 并 
且 将 Expires 值 也 设置 成 一 个 已 经 过 去 的 时 间 ; 


(2) 使 用 Setcookie 方法 将 刚刚 创建 的 同名 cookie 发 送 至 客户 


E 
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实际 上 ， 因 为 狐 cookie 的 MaxAge 值 为 负数 ， 并 且 Expires 值 也 是 一 
个 已 经 过 去 的 时 间 ， 所 以 这 样 做 实际 上 束 是 要 完全 地 移 除 这 个 cookie。 
在 设置 完 新 cookie 之 后 ， 程 序 会 对 存储 在 旧 cookie 中 的 消息 进行 解码 ， 
并 通过 啊 应 返回 这 条 消 恩 。 


现在 ， 让 我 们 实际 运行 这 个 服务 器 ， 然 后 打开 浏 贤 妖 并 访问 地 址 
http://localhost:8080/set_ message ° 如果 一 切 顺 利 ， 你 将 在 WebInspector 
中 看 到 图 4-4 所 示 的 cookie ° 


eee Web Inspector — 127.0.0.1 — set_message 


O M Z o = & 


Resources Timelines Debugger Console Inspect 
< © Cookies 
<>) set. message 一 127.0.0.1 Œ © Name Value Domain Path Expires Size HTTP Securi 
& Cookies — 127.0.0.1 flash SGVsbG8gV29ybGQh 127.0.0.1 / Session 21B 


ER Local Storage 一 127.0.0.1 
EH Session Storage — 127.0.0.1 


S 


电码 的 闪现 消息 


图 4-4 在 Safari 浏 览 器 附带 的 WebInspector 中 查看 已 被 


注意 ， 因 为 图 中 cookie 的 值 已 经 被 Base64 URL 编 码 过 了 ， 所 以 它 初 
看 上 去 束 像 乱码 一 样 。 不 过 我 们 只 要 使 用 浏 贤 壤 访问 
http://localhost:8080/show_message， 就 可 以 看 到 解码 之 后 的 真正 的 消 


JOY? 


Hello World! 


如 果 你 现在 再 去 看 WebInspector， 就 会 发 现 之 前 设置 的 cookie 已 经 
ART: 通过 设置 同名 的 cookie， 程 序 成 功 地 使 用 新 cookie 人 代替 了 旧 
cookie; 与 此 同时 ， 因 为 新 cookie 的 MaxAge 值 为 负数 ， 并 且 它 的 
Expires 值 也 是 一 个 已 经 过 去 的 时 间 ， 这 相当 于 命令 浏 贤 器 删除 这 个 
cookie， 所 以 这 个 新 设置 的 cookie 也 被 移 除 了 。 


现在 ， 如 果 刷 新 网 页 ， 或 者 再 次 访问 
http:Wlocalhost:8080/show_message， 你 将 看 到 以 下 消息 : 


No message found 


本 章 沿 着 上 一 章 的 脚步 ， 介 绍 了 net/http 在 Web 应 用 开发 方面 提 
供 的 服务 器 端 功 能 ， 而 接 下 来 的 一 章 将 对 Web 应 用 的 另 一 个 主要 组 成 部 
分 一 一 模板 一 一 进行 介绍 ， 我 们 将 会 了 解 到 Go 语言 的 模板 以 及 模板 引 
敬 ， 并 学 会 如 何 使 用 它们 为 客户 端 生成 啊 应 。 


4.5 ”小 结 


。 Go 语言 提供 了 多 种 不 同 的 结构 ， 用 于 表示 HTTP 请 求 的 各 个 不 同 部 
分 ， 从 这 些 结构 里 面 可 以 提取 出 请 求 包含 的 各 项 信息 。 

Request 结构 的 Form、PostForm 和 MultipartForm 字段 可 
以 让 用 户 更 容易 地 提取 出 请 求 中 的 不 同 数据 : 用 户 只 要 调用 
ParseForm 方法 或 者 ParseMultipartForm 方法 对 请 求 进行 
语法 分 析 ， 然 后 访问 相应 的 字段 ， 就 可 以 取得 请 求 中 包含 的 数 

据 。 

Form 字段 存储 的 是 来 目 URL 以 及 HTML 表 单 的 URL 编 码 数 据 ， 
Post 字段 存储 的 是 来 自 HTML 表 单 的 URL 编 码 数据 ， 而 
MultipartForm 字段 存储 的 则 是 来 和 目 URL 以 及 HTML 表 单 的 
multipart 编 码 数据 。 

服务 器 通过 向 Responsewriter 写 入 首部 和 主体 来 向 客户 端 返 
回 啊 应。 


e 通过 回 Responsewriter 5 Acookie, AKA ax A) LUTE AHL 
存储 在 客户 端 上 。 
e coOokie 可 以 用 于 实现 闪现 消息 。 


第 5 章 ”内 容 展示 


本 章 主要 内 容 


。 模板 以 及 模板 引擎 

。 Go 语言 的 模板 库 text/template 和 html/template 
。 模板 中 的 动作 、 管 道 以 及 函数 

。 航 套 的 模板 与 布局 


Web 模 板 丈 是 一 些 预 匈 设计 好 的 HIML 页面， 名 为 模板 引擎 的 软 
件 程序 会 通过 重复 地 使 用 这 些 页 面 来 创建 一 个 或 多 个 HTML 页 面 。Web 
模板 引擎 是 Web 应 用 框架 的 重要 组 成 部 分 ， 绝 大 多 数 成 熟 的 框架 都 会 拥 
有 相应 的 模板 引擎 : 有 一 小 部 分 框架 的 模板 引擎 是 直接 航 入 框 以 里 面 
的 ， 而 其 他 绝 大 多 数 框 腑 都 允许 用 户 像 吃 目 助 餐 一 样 ， 根 据 目 己 的 喜 
好 选择 相应 的 模板 引擎 。 


Go 语言 也 不 例外 一 一 尽管 Go 还 是 一 门 相对 较 新 的 编程 语言 ， 但 已 
经 出 现 了 一 些 使 用 Go 语言 构建 的 模板 引擎 ， 除 此 之 外 ，Go 的 标准 库 也 
通过 text/template 和 html/template 这 两 个 库 为 模板 提供 了 强 
有 力 的 支持 ， 并 且 毫 不 意外 地 很 多 Go 框架 都 使 用 了 这 两 个 库 作 为 默认 
的 模板 引擎 。 


本 章 将 对 上 面 提 到 的 两 个 库 进 行 介绍 ， 并 说 明 如 何 使 用 它们 生成 
HTML 响 应 。 


5.1 模板 引擎 


如 图 5-1 所 示 ， 模 板 引 警 通 过 将 数据 和 模板 组 合 在 一 起 生成 最 终 的 
HTML, ， 而 处 理 硕 则 负责 调用 模板 引擎 并 将 引擎 生成 的 HIML 返 回 给 客 
Fm ° 


如 前 所 述 ，Web 模 板 引 警 演 变 自 SSI 〈 服 务 器 端 包含 ) 技术 ， 并 最 
终 衍 生出 了 诸如 PHP、ColdFusion 和 JSP 这 样 的 web 编 程 语言 。 这 种 演变 
导致 的 一 个 结果 是 模板 引擎 并 没有 相应 的 标准 ， 并 且 对 各 个 因为 不 同 
原因 创造 出 来 的 模板 引擎 来 说 ， 它 们 拥有 的 特性 也 是 五 花 八 门 、 各 不 
相同 的 。 不 过 大 致 来 讲 ， 我 们 可 以 把 模板 引擎 划分 为 两 种 理想 的 类 
型 ， 这 两 种 类 型 的 模板 正好 处 于 两 个 极端 。 
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图 5-1 模板 引擎 通过 组 合 数据 和 模板 来 生成 最 终 展 示 的 HTML 


。 无 逻辑 模板 引擎 〈logic-less template engine) 将 模板 中 指定 的 
占 位 符 替 换 成 相应 的 动态 数据 。 这 种 模板 引擎 只 进行 字符 串 替 
换 ， 而 不 执行 任何 逻辑 处 理 。 无 逻辑 模板 引 警 的 目的 是 完全 分 离 


程序 的 表现 和 逻辑 ， 并 将 所 有 计算 方面 的 工作 都 交 给 处 理 器 完 
成 o 

髓 入 逻辑 的 模板 引 警 (embedded logic template engine) 将 编 
程 语言 代码 敬 入 模板 当中 ， 并 在 模板 引 苟 洽 染 模板 时 ， 由 模板 引 
擎 执行 这 些 代 码 并 进行 相应 的 字符 串 奉 换 工 作 。 因 为 拥有 在 模板 
里 面 蔡 入 逻辑 的 能 力 ， 所 以 这 类 模板 引擎 能 够 妆 得 非 党 强大， 但 
与 此 同时 ， 这 种 能 力也 会 导致 允 辑 分 散 遇 布 在 不 同 鸭 处 理 人 右 之 
间 ， 使 代码 变 得 难以 维护 。 


因为 不 需要 进行 逻辑 处 理 ， 所 以 无 逻辑 模板 引 敬 的 泻 染 速度 往往 
会 更 快 一 些 。 一 些 模板 引擎 虽然 目 称 是 无 逻辑 模板 引擎 ， 但 它们 实际 
上 并 非 只 执行 字符 串 替 换 操作 。 比 如 ，Mustache 虽 然 自称 是 无 逻辑 模 
板 引 擎 ， 但 它 实 际 上 也 提供 了 一 些 能 够 执行 条 件 判 断 操 作 和 循环 操作 
的 标签 (tag) ° 


另外 ， 最 极端 的 岁入 逻辑 模板 引 敬 通常 表现 得 跟 普 通 的 编程 语言 
一 样 ， 比 如 PHP 就 是 一 个 很 好 的 例子 : PHP 一 开始 是 作为 独立 的 Web 模 
板 引 苟 出 现 的 ， 但 今 时 今日 的 很 多 PHP 页 面 已 经 很 难看 到 哪怕 一 行 
HIML 人 代码， 我 们 甚至 已 经 不 太 可 能 继续 把 PHP 看 作 是 一 个 模板 引擎 
了 ， 实 际 上 PHP 本 里 就 拥有 很 多 模板 引 敬 ， 比 如 ，Smarty 和 Blade 都 是 
为 PHP 构 建 的 。 


对 于 骨 入 逻辑 模板 引擎 的 最 大 争论 ， 束 是 认为 它 把 表现 和 人 逻辑 搅 
合 在 了 一 起 ， 并 将 逻辑 分 获 在 多 个 不 同 的 地 方 ， 导 致 代码 变 得 难以 维 
护 。 而 对 于 无 逻辑 模板 引擎 的 争论 则 是 认为 这 种 理想 化 的 模板 引擎 并 
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辑 ， 并 因此 给 处 理 器 带 来 不 必要 的 复杂 度 。 


在 实际 中 ， 绝 大 多 数 有 用 的 模板 引擎 都 会 介 于 以 上 这 两 种 理想 的 
模板 引擎 之 间 ， 其 中 有 些 模板 引擎 更 接近 于 无 逻辑 模板 引擎 ， 而 其 他 
一 些 模板 引擎 则 更 接近 于 藤 入 还 错 模 板 引 擎 。Go 标 准 库 提 供 的 模板 引 
擎 功能 大 部 分 都 定义 在 了 text/template 库 当 中 ， 而 小 部 分 与 HTML 
相关 的 功能 则 定义 在 了 html/template 库 里 面 。 这 两 个 库 相 辅 相 
成 : 用 户 可 以 把 这 个 模板 引擎 当做 无 逻辑 模板 引擎 使 用 ， 但 与 此 同 
时 ，Go 也 提供 了 足够 多 的 舱 入 式 模板 引擎 特性 ， 使 这 个 模板 引擎 用 起 
来 既 有 趣 又 强大 。 


5.2 Go 的 模板 引擎 


跟 其 他 大 多 数 模板 引擎 一 样 ，Go 语 言 的 模板 引 警 也 是 介 于 无 逻辑 
模板 引 警 和 航 入 逻辑 模板 引擎 之 间 的 一 种 模板 引擎 。 在 Web 应 用 里 面 ， 
模板 引擎 通常 由 处 理 器 负责 触发 。 作 为 例子 ， 图 5-2 展 示 了 处 理 器 调用 
Go 模板 引擎 的 流程 处 理 絮 首先 调用 模板 引 敬 ， 接 着 以 模板 文件 列表 
的 方式 向 模板 引擎 传 入 一 个 或 多 个 模板 ， 然 后 再 传 入 模板 需要 用 到 的 
动态 数据 ;模板 引擎 在 接收 到 这 些 参 数 之 后 会 生成 出 相应 的 HTIML ， 并 
将 这 些 文件 写 入 到 ResponseWriter 里 面 ， 然 后 由 
Responsewriter 将 HTTP 响 应 返回 给 客户 端 。 


图 5-2 Go 模板 引擎 在 web 应 J 的 作 In 


Go 的 模板 都 是 文本 文档 (其 中 Web 应 用 的 模板 通常 都 是 HTML) , 
它们 都 租 入 了 一 些 称 为 动作 (action) 的 指令 。 从 模板 引擎 的 角度 来 
说 ， 模 板 就 是 敬 入 了 动作 的 文本 (这 些 文本 通常 包含 在 模板 文件 里 
面 ) ， 而 模板 引 警 则 通过 分 析 并 执行 这 些 文本 来 生成 出 另外 一 些 文 
本 。Go 语 言 拥 有 通用 模板 引 警 库 text/temp1late ， 它 可 以 处 理 任 意 
格式 的 文本 ， 除 此 之 外 ，Go 语 言 还 拥有 专门 为 HIML 格 式 而 设 的 模板 
引 警 库 htm1L/temp1Late 。 模 板 中 的 动作 默认 使 用 两 个 大 括号 {{ 和 }} 
包围 ， 如 果 用 户 有 需要 ， 也 可 以 通过 模板 引 警 提供 的 方法 自行 指定 其 
他 定 界 符 (delimiter) 。 本 章 稍 后 将 对 动作 做 更 详细 的 介绍 ， 在 此 之 
前 ， 让 我 们 先 来 看 一 下 代码 清单 5-1 展 示 的 这 个 非常 简单 的 模板 。 


代码 清单 5-1 一 个 简单 的 模板 


<!DOCTYPE html> 


<meta http-equiv="Content-Type" content="text/html; charset=utf- 


</head> 


代码 清单 5-1 展 示 的 模板 来 源 于 一 个 名 为 tmp1.html 的 模板 文 
件 。 用 户 可 以 拥有 任意 多 个 模板 文件 ， 并 且 这 些 模板 文件 可 以 使 用 任 
意 后 级 名 ， 但 它们 的 类 型 必须 是 可 读 的 文本 格式 。 因 为 上 面 这 上 段 模 板 
的 输出 将 是 一 个 HTML 文 件 ， 所 以 我 们 使 用 了 .html 作为 模板 文件 的 
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注意 ， 模 板 中 被 两 个 大 括号 包围 的 点 (.) 是 一 个 动作 ， 它 指示 模 
板 引擎 在 执行 模板 时 ， 使 用 一 个 值 去 替换 这 个 动作 本 身 。 


使 用 Go 的 Web 模 板 引擎 需要 以 下 两 个 步骤 


(1) 对 文本 格式 的 模板 源 进行 语法 分 析 ， 创 建 一 个 经 过 语法 分 析 
的 模板 结构 ， 其 中 模板 源 既 可 以 是 一 个 字符 串 ， 也 可 以 是 模板 文件 中 
包含 的 内 容 ; 


(2) 执行 经 过 语法 分 析 的 模板 ， 将 Responsewriter 和 模板 所 
需 的 动态 数据 传递 给 模板 引擎 ， 被 调用 的 模板 引擎 会 把 经 过 语法 分 析 
的 模板 和 传 入 的 数据 结合 起 来 ， 生 成 出 最 终 的 HTML ， 并 将 这 些 HTML 


传递 给 ResponseWriter 。 


代码 清单 5-2 展 示 了 一 个 简单 而 且 具 体 的 模板 引擎 使 用 例子 。 


代码 清单 5-2 ”在 处 理 器 函数 中 触发 模板 引擎 


package main 


import ( 
"net/http" 
"html/template" 

) 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, "Hello World!") 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


代码 清单 5-2 展 示 的 服务 器 代码 跟 之 前 展示 过 的 服务 器 代码 非常 相 
似 ， 主 要 的 区 别 在 于 这 次 的 服务 器 使 用 了 一 个 名 为 process HJE er 
函数 ， 而 模板 引 敬 就 是 由 这 个 函数 负责 触发 的 。process 函数 首先 使 
用 ParseFiles 函数 对 模板 文件 tmpl .html 进行 语法 分 析 ， 
ParseFiles 函数 在 执行 完毕 之 后 将 返回 一 个 Template 类 型 的 已 分 
析 模 板 和 一 个 错误 作为 结果 ， 不 过 为 了 保持 代码 的 简洁 ， 我 们 这 里 和 暂 
时 把 这 个 错误 忽略 了 : 


t, _ := template.ParseFiles("tmpl.html") 


在 此 之 后 ，process 函数 会 调用 Execute 方法 ， 将 数据 应 用 
(apply) 到 模板 里 面 一 一 在 这 个 例子 中 ， 数 据 就 是 字符 串 "Hello 
World!" : 


t.Execute(w, "Hello World!") 


Responsewriter 和 数据 会 一 起 被 传人 Execute 方法 中 ， 这 样 
一 来 ， 模 板 引 擎 在 生成 HTML 之 后 就 可 以 把 该 HTML 传 给 
Responsewriter 了 。 另 外 需要 注意 的 是 ， 因 为 这 个 服务 器 在 指定 模 
板 位 置 时 并 没有 给 出 模板 文件 的 绝对 路 径 ， 所 以 我 们 在 运行 这 个 服务 
妖 的 上 时候 ， 需 要 把 模板 文件 和 服务 器 的 二 进 制 文件 放 到 同一 个 目录 里 
面 。 


以 上 展示 的 就 是 模板 引擎 的 最 基本 用 法 ， 正 如 你 所 料 ， 除 了 . 之 
外 ，Go 的 模板 引擎 还 提供 了 其 他 动作 供用 户 使 用 ， 本 章 将 在 稍 后 的 内 
容 中 对 这 些 动作 做 进一步 的 介绍 。 


5.2.1 对 模板 进行 语法 分 析 


ParseFiles 是 一 个 独立 的 (standalone) 函数 ， 它 可 以 对 模板 文 
件 进行 语法 分 析 ， 并 创建 出 一 个 经 过 语法 分 析 的 模板 结构 以 供 
Execute 方法 执行 。 实 际 上 ，ParseFiles 函数 只 是 为 了 方便 地 调用 
Template 结构 的 ParseFiles 方法 而 设置 的 一 个 函数 一 一 当 用 户 调 
用 ParseFiles 函数 的 时 候 ，Go 会 创建 一 个 新 的 模板 ， 并 将 用 户 给 定 
的 模板 文件 的 名 字 用 作 这 个 新 模板 的 名 字 : 


_ := template.ParseFiles("tmpl.htm1l") 


这 相当 于 创建 一 个 新 模板 ， 然 后 调用 它 的 ParseFiles 方法 : 


:= template.New("tmpl.html") 


t 
t, := t.ParseFiles("tmpl.htm1") 


无 论 是 ParseFiles 函数 还 是 Template 结构 的 ParseFiles FH 
法 ,它们 都 可 以 接受 一 个 或 多 个 文件 名 作为 参数 ， 换 句 话说， 这 两 个 
函数 /方法 都 是 可 变 参 数 函 数 /方法 ， 它 们 可 以 接受 的 参数 数量 是 可 变 
的 。 但 与 此 同时 ， 无 论 这 两 个 函数 /方法 接受 多 少 个 文件 名 作为 输入 ， 
它们 都 只 返回 一 个 模板 。 


当 用 户 向 ParseFiles 函数 或 ParseFiles 方法 传 入 多 个 文件 
hf, ParseFiles 只 会 返回 用 户 传 入 的 第 一 个 文件 的 已 分 析 模 板 ， 并 
且 这 个 模板 也 会 根据 用 户 传 入 的 第 一 个 文件 的 名 字 进 行 命名 ; 至 于 其 
他 传 入 文件 的 已 分 析 模 板 则 会 被 放置 到 一 个 映射 里 面 ， 这 个 映射 可 以 
在 之 后 执行 模板 时 使 用 。 换 名 话说， 我 们 可 以 这 样 认 为 : TA 
ParseFiles 传 入 单个 文件 时 ，ParseFiles 返回 的 是 一 个 模板 ; 而 
在 向 ParseFiles 传 入 多 个 文件 时 ，ParseFiles 返回 的 则 是 一 个 模 
板 集合 ， 理 解 这 一 点 能 够 帮助 我 们 更 好 地 学 习 本 章 稍 后 将 要 介绍 的 符 
套 模板 技术 。 


对 模板 文件 进行 语法 分 析 的 男 一 种 方法 是 使 用 ParseGlob 函数 ， 
跟 ParseFiles 只 会 对 给 定 文件 进行 语法 分 析 的 做 法 不 同 ， 
ParseGlob 会 对 匹配 给 定 模式 的 所 有 文件 进行 语法 分 析 。 举 个 例子 ， 
如 果 目 录 里 面 只 有 tmpl.html 一 个 HTML 文件 ， 那 么 语句 


_ := template.ParseFiles("tmpl.html") 


和 语句 


t, _ := template.ParseGlob("*.html") 


将 产生 相同 的 效果 。 


在 绝 大 多 数 情况 下 ， 程 序 都 是 对 模板 文件 进行 语法 分 析 ， 但 是 在 
需要 时 ， 程 序 也 可 以 直接 对 字符 串 形 式 的 模板 进行 语法 分 析 。 实 际 
上 ， 所 有 对 模板 进行 语法 分 析 的 手段 最 终 都 需要 调用 Parse 方法 来 执 
行 实际 的 语法 分 析 操 作 。 比 如 说 ， 在 模板 内 容 相同 的 情况 下 ， 语 名 


t, _ := template.ParseFiles("tmpl.html") 


和 代码 


`<!DOCTYPE html> 


<meta http-equiv="Content-Type" content="text/html; charset=utf- 


8"> 
<title>Go Web Programming</title> 
</head> 


:= template.New("tmpl.htm1l") 
, — = t.Parse(tmpl) 
.Execute(w, "Hello World!") 


将 产生 相同 的 效果 。 


到 目前 为 上 ， 本 章 一 直 都 没有 处 理 分 析 模 板 时 可 能 会 产生 的 错 
误 。 里 然 Go 语 言 的 一 般 做 法 是 手动 地 处 理 错误 ， 但 Go 也 提供 了 另外 一 
种 机 制 ， 专 门 用 于 处 理 分 析 模 板 时 出 现 的 错误 : 


t := template.Must(template.ParseFiles("tmpl.htm1") ) 


Must 函数 可 以 包 右 起 一 个 芳 数 ， 被 包 于 的 范 数 会 返回 一 个 指 册 模 
板 的 指针 和 一 个 错误 ， 如 果 这 个 错误 不 是 nil ， 那 么 Must 函数 将 产生 
一 个 panic。 〈 在 Go 里 面 ，panic 会 导致 正音 的 执行 流程 被 终止 : 如 来 
panic 十 在 琴 数 内 部 产生 的 ， 那 么 范 数 会 将 这 个 panic 返 回 给 它 的 调用 
者 。panic 会 一 直 向 调用 栈 的 上 方 传递 ， 直 至 main 函数 为 止 ， 并且 程序 
ZATAR °) 


5.2.2 ”执行 模板 


执行 模板 最 常用 的 方法 就 是 调用 模板 的 Execute 方法 ， 并 向 它 传 
递 Responsewriter 以 及 模板 所 需 的 数据 。 在 只 有 一 个 模板 的 情况 
下 ， 上 面 提 到 的 这 种 方法 总 是 可 行 的 ， 但 如 有 果 模 板 不 止 一 个 ， 那 么 当 
对 模板 集合 调用 Execute 方法 的 时 候 ，Execute 方法 只 会 执行 模板 
集合 中 的 第 一 个 模板 。 如 果 想 要 执行 的 不 是 模板 集合 中 的 第 一 个 模板 
而 是 其 他 模板 ， 就 需要 使 用 Execute Template 方 法 。 比 如 ， 对 以 下 语 
名 来 说 : 


_ := template.ParseFiles("ti.html", "t2.html") 


变量 t 束 古 一 个 包含 了 两 个 模板 的 模板 集合 ， 其 中 第 一 个 模板 名 为 
t1.html ， 而 第 二 个 模板 则 名 为 t2.,html (正如 前 面 所 说 ， 除 非 显 
式 地 对 模板 名 进行 修改 ， 否 则 模板 的 名 子 和 后 缀 名 将 由 传 入 的 模板 文 
FRE) 。 如 采 对 这 个 模板 集合 调用 Execute 方法 : 


t.Execute(w, "Hello World!") 


就 只 有 模板 t1.,html 会 被 执行 。 如 果 想 要 执行 的 是 模板 t2 ,html 而 
不 是 t1.,htm1 ， 则 需要 执行 以 下 语句 : 


t.ExecuteTemplate(w, "t2.html", "Hello World!") 
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下 来 我 们 要 学 习 的 是 如 何 使 用 Go 语言 提供 的 各 种 模板 动作 。 


5.3 ”动作 


正如 之 前 所 说 ，Go 模 板 的 动作 吏 是 一 些 舱 入 在 模板 里 面 的 命令 ， 
命令 在 模板 中 使 用 两 个 大 括号 {{ 和 }} 进行 包围 。Go 拥 有 一 父 非 
量 的 动作 和 集合， 它们 不 仅 功 能 强大 ， 而 且 还 非 第 灵 活 多 变 。 本 六 
讨 沦 以 下 几 种 主要 的 动作 : 


这 些 
常 丰 
将 


。 条件 动作 ; 
e SARDE; 
。 设置 动作 ; 


。 包含 动作 。 


除了 以 上 4 种 动作 之 外 ， 本 章 稍 后 还 会 介绍 另外 一 种 重要 的 动作 
一 一 定义 动作 。 如 果 读 者 对 其 他 类 型 的 动作 也 感 兴趣 ， 那 么 可 以 参考 
text/template 库 的 文档 。 


虽然 初 看 上 去 可 能 会 让 人 感到 惊讶 ， 但 其 实 点 (Q) 也 是 一 个 动 
作 ， 并 且 且 最 为 重要 的 一 个 ， 写 代表 的 是 传递 给 模板 的 数据 ， 其 他 动 
作 和 函数 基本 上 痢 会 对 这 个 动作 进行 处 理 ， 以 此 来 达到 格式 化 和 内 容 
展示 的 目的 。 


5.3.1 条件 动 作 


条 件 动作 会 根据 参数 的 值 来 决定 对 多 条 语句 中 的 哪 一 条 语句 进行 
求 值 。 最 简单 的 条 件 动作 的 格式 如 下 : 


{{ if arg }} 


some content 


{{ end }} 


这 个 动作 的 发 一 种 格式 如 下 : 


{{ if arg }} 


some content 


{{ else }} 


other content 
{{ end }} 


以 上 两 种 格式 中 的 arg 都 是 传递 给 条 件 动作 的 参数 。 本 章 稍 后 会 
对 动作 的 参数 做 更 详细 的 介绍 ， 目 前 来 说 ， 我 们 可 以 把 参数 看 作 坪 一 
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: nee et 诸如 此 类 。 现 在 ， 让 我 们 来 看 一 下 如 何在 模板 中 使 用 

这 个 条 件 动 作 。 如 代码 清单 5-3 所 示 ， 我 们 会 在 服务 器 上 面 创建 一 个 处 
理 右 ， 这 个 处 理 套 会 随机 地 生成 介 于 0 至 10 之 间 的 随机 整数 ， 然 后 通过 
判断 这 个 随机 整数 是 否 大 于 5 来 创建 出 一 个 布尔 值 ， 并 在 最 后 将 这 个 布 
尔 值 传递 给 模板 。 


代码 清单 5-3 ”在 处 理 器 里 面 生成 一 个 随机 数 


package main 


import ( 
"net/http" 
"html/template" 
"math/rand" 
UL! time" 


) 


func process(w http.Responsewriter, r ”http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
rand.Seed(time.Now().Unix()) 
t.Execute(w, rand.Intn(10) > 5) 


func main() < 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


} 


在 此 之 后 ， 我 们 需要 在 模板 文件 tmp1L.html 里 面 对 传 入 的 参数 进 
行 测试 ， 并 根据 测试 的 结果 ， 在 页 面 上 显示 “Number is greater than 5! 
”和 “Number is 5 or less! ”这 两 条 消 居中 的 一 条 ， 具 体 的 做 法 如 代码 清单 


5-4 所 示 。 (正如 之 前 所 说 ， 动 作 . 代表 的 是 处 理 器 传递 给 模板 的 数 
据 ， 在 这 个 例子 中 ，. 代表 的 是 被 传 入 的 布尔 值 。) 


代码 清单 5-4 使 用 了 条 件 动作 的 模板 文件 tmp1.html 


<!DOCTYPE html> 
<html> 


<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf- 
8"> 
<title>Go Web Programming</title> 
</head> 


<body> 
{{ if . }} 
Number is greater than 5! 
{{ else }} 
Number is 5 or less! 
{{ end }} 
</body> 
</html> 


5.3.2 ”迭代 动作 


适 代 动作 可 以 对 数组 、 切 片 、 有 映射 或 者 通 道 进 行 和 迭代 ， 而 在 适 代 
循环 的 内 部 ， 点 C) 则 会 被 设置 为 当前 被 迭代 的 元 素 ， 束 像 这 样 : 


{{ range array }} 
Dot is set to the element {{ . }} 


{{ end }} 
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代码 清单 5-5 ”迭代 动作 示例 


<!DOCTYPE html> 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf- 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<ul> 
{{ range . }} 
<li>{{ . }}</li> 
{{ end}} 
</ul> 
</body> 
</html> 
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func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
daysOfWeek := []string{"Mon", "Tue", "Wed", "Thu", "Fri", "Sat", 


"Sun" } 


t.Execute(w, daysOfWeek ) 
} 


这 段 代 码 创 建 了 一 个 切片 ， 并 在 切片 里 面包 含 了 周一 到 周 日 的 英 
文 缩写 ， 然 后 将 它 传 递 给 模板 。 接 看 ， 这 个 切片 会 钻 传 递 至 语句 { 
range . }} 中 的 ,里面 ,然后 由 range 动作 对 这 个 切片 中 的 各 个 元 
素 进行 迭代 。 


AIA PA L{ . }} 代表 的 是 当前 说 碗 代 的 切片 元 素 ， 图 5-3 展 
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00o 127.0.0.1:8080/process Č ü 


了 


图 5-3 ”使 用 迭代 动作 实现 欠 代 


代码 清单 5-6 展 示 了 和 迭代 动作 的 一 个 变种 ， 这 个 变种 允许 用 户 在 被 
迭代 的 数据 结构 为 空 时 ， 显 示 一 个 备 选 的 (fallback) 结果 。 


吉 末 的 迭代 动作 


es 
at 
at 
EN 
SE 
N 


代码 清单 


<html> 


<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<ul> 
{{ range . }} 
<li>{{ . }}</li> 
{{ else }} 


<li> Nothing to show </li> 


{{ end}} 


</ul> 
</body> 
</html> 


模板 里 面 介 于 {{ else }} 和 {{ end }} 之 间 的 内 容 将 在 点 (. 
) Anil 时 显示 。 在 这 个 例子 中 ， 被 显示 的 将 是 文本 “Nothing to 


show” ° 


5.3.3 ”设置 动作 


设置 动作 允许 用 户 在 指定 的 范围 之 内 为 点 (.) 设置 值 。 比 如 , 在 
以 下 代码 中 : 


{{ with arg }} 


Dot is set to arg 


{{ end }} 


介 于 {{ with arg }} 和 {{ end }} 之 间 的 点 将 被 设置 为 参数 arg 
的 值 。 再 次 修改 的 tmp1.html 文件 如 代码 清单 5-7 所 示 ， 这 是 一 个 更 
为 具体 的 例子 。 


p 
Iy 


代码 清单 5-7 对 点 进行 设置 


<html> 


<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
sys 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>The dot is {{ . }}</div> 
<div> 
{{ with "world"}} 
Now the dot is set to {{ . }} 


{{ end }} 
</div> 
<div>The dot is {{ . }} again</div> 
</body> 
</html> 


至 于 调用 这 个 模板 的 处 理 右 则 会 将 子 符 串 "hello" 传递 给 模板 : 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 


t.Execute(w, "hello" ) 


这 样 一 来 ， 位 于 {{ with "world" y} 之 前 的 点 就 会 因为 处 理 器 传 

入 的 值 而 被 设置 成 hello ， 而 位 于 {{ with "world" }} << 

end }} 之 间 的 点 则 会 被 设置 成 world ; 但 是 ， 在 语句 {{ end }} i 
行 完毕 之 后 ， 点 的 值 又 会 重新 被 设置 成 hello ， 如 图 5-4 所 示 。 


eee < 127.0.0.1:8080/process Č 由 [+ 


The dot is hello 


The dot is hello again 


图 5-4 ”使 用 设置 动作 对 点 O) 进行 设置 
BUST OEE, KE OE Meme ita RNS 
种 : 


{{ with arg }} 
Dot is set to arg 


{{ else }} 
Fallback if arg is empty 


{{ end }} 


代码 清单 5-8 展 示 了 这 一 变种 的 使 用 方法 。 


代码 清单 5-8 ”在 设置 点 的 时 候 提供 备 选 方案 


<html> 
<head> 


<meta http-equiv="Content-Type" content="text/html; charset=utf - 
875 
<title>Go Web Programming</title> 


<div>The dot is {{ . }}</div> 
<div> 
{{ with "" }} 

Now the dot is set to {{ . }} 
{{ else }} 

The dot is still {{ . }} 
{{ end }} 

</div> 

<div>The dot is {{ . }} again</div> 
</body> 

</html> 


因为 传 给 with 动作 的 参数 为 空子 符 串 "" ， 所 以 模板 将 显示 {{ 
else 7) 语句 之 后 的 内 容 ， 此 外 ， 因 为 with 动作 并 没有 修改 点 〈， 
) 的 值 ， 所 以 模板 打印 出 来 的 仍然 是 处 理 器 传 入 的 值 "hello" 。 执 行 
这 个 新 模板 不 需要 对 处 理 器 或 者 服务 絮 进 行 任何 修改 ， 也 不 需要 重启 
服务 器 ， 只 要 刷新 一 下 浏 贤 右 ， 束 会 看 到 图 5-5 所 示 的 结果 。 


eee < 127.0.0.1:8080/process Č 由 
The dot is hello 


The dot is hello again 


图 5-5 ”在 设置 点 (C) 时 提供 备 选 方案 


5.3.4 包含 动作 

包含 动作 (include action) 人 允许 用 户 在 一 个 模板 里 面包 含 另 一 个 模 
板 ， 从 而 构建 出 棚 套 的 模板 。 包 含 动 作 的 格式 为 {{ template 
"name" }} ， 其 中 name 参数 为 被 包含 模板 的 名 字 。 


代码 清单 5-9 展 示 了 一 个 使 用 包含 动作 的 例子 ， 在 这 个 例子 中 ， 模 
板 t1.html 包含 了 模板 t2 ,htm1 ° 


代码 清单 5-9 ”模板 t1.html 


<!DOCTYPE html> 
<html lang="en"> 
<head> 


<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=9"> 
<title>Go Web Programming</title> 

</head> 

<body> 
<div> This is t1.html before</div> 
<div>This is the value of the dot in t1.html - [{{ . }}]</div> 
<hr/> 
{{ template "t2.html" }} 
<hr/> 
<div> This is t1.html after</div> 

</body> 

</html> 


正如 代码 所 示 ， 模 板 文件 的 名 字 将 被 用 作 模 板 的 名 字 。 记 住 ， 如 
果 用 户 在 创建 模板 的 时 候 没 有 为 模板 指定 名 字 ， 那 么 Go 语言 在 命名 模 
板 时 将 沿用 模板 文件 的 名 字 及 扩展 名 。 


代码 清单 5-10 展 示 了 被 包含 的 模板 t2 .htm1 ， 这 个 模板 是 一 段 
HTML 代 码 片 段 。 


代码 清单 5-10 ”模版 t2.html 


<div style="background-color: yellow;"> 
This is t2.html<br/> 


This is the value of the dot in t2.html - [{{ . }}] 
</div> 


代码 清单 5-11 展 示 了 使 用 以 上 两 个 模板 的 处 理 器 。 


代码 清单 5-11 调用 岁 套 模板 的 处 理 器 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("t1.html", "t2.html") 
t.Execute(w, "Hello World!") 


PO 

跟 之 前 展示 的 代码 不 同 ， 在 执行 嵌 套 模板 时 ， 我 们 必须 对 涉及 的 
所 有 模板 文件 都 进行 语法 分 析 。 补 记 这 一 点 是 非 冲 重要 的 ， 环 记 对 必 
要 的 模板 文件 进行 语法 分 析 将 导致 程序 出 现 不 正确 的 结 


因为 上 面 的 代码 并 没有 为 模板 设置 名 字 ， 所 以 模板 集合 中 的 模板 
将 沿用 模板 文件 的 名 字 。 正 如 之 前 所 说 ，ParseFiles 函数 的 第 一 个 
参数 是 具有 特殊 作用 的 :在 进行 语法 分 析 时 ， 用 户 给 定 的 第 一 个 模板 
文件 将 成 为 主 模板 (main template) ， 当 用 户 对 模板 集合 调用 
Execute 方法 时 ， 主 模板 将 被 执行 。 


图 5-6 展 示 了 服务 器 在 执行 上 述 模 板 之 后 同 浏 咒 器 返回 的 结果 。 


如 图 5-6 所 示 ， 模 板 t1.html 中 的 点 (. ) 被 传 入 的 "Hello 
World!" 准确 无 误 地 替换 掉 了 ， 并 且 模 板 t2 .html 的 内 容 也 出 现在 
了 语句 {{f template "t2.html" }} 所 在 的 位 置 。 因 为 模板 
t1.html 并 没有 把 字符 串 "Hello World!" 也 传递 给 被 内 套 的 模板 
t2.html ， 所 以 t2.html 中 的 点 的 打印 结果 为 空 字符 串 。 为 了 向 被 
般 套 的 模板 传递 数据 ， 用 户 可 以 使 用 包含 动作 的 变种 {{ template 
"name" arg }} ， 其 中 arg WH PRE eA KERR 
据 ， 代 码 清单 5-12 展 示 了 这 个 变种 的 具体 使 用 方法 。 


608 < 127.0.0.1:8080/process ag 由 


This is tl html before 
This is the value of the dot in tl .html - [Hello World!] 


This is tl .html after 
图 5-6 fr ROR AY Sai aR 
代码 请 单 5-12 ”通过 参数 将 模板 t1.html PHATE RAR REA t2. html 


<html> 

<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=9"> 
<title>Go Web Programming</title> 

</head> 

<body> 
<div> This is ti.html before</div> 


<div>This is the value of the dot in t1.html - [{{ . }}]</div> 
<hr/> 


{{ template "t2.html" . }} 
<hr /> 
<div> This is ti.html after</div> 
</body> 
</html> 


这 个 模板 唯一 的 改动 就 是 在 t1.html 里 面 将 点 传递 给 了 t2.html 
° 现 在， 如果 我 们 再 次 执行 这 个 模板 ， 它 将 产生 图 5-7 所 示 的 结果 。 


68088 < 127.0.0.1:8080/process 由 + 
| 


This is tl html before 
This is the value of the dot in tl .html - [Hello World!] 


This is tl .html after 


图 5-7 KARE EA RE AL 


本 章 稍 后 将 再 次 回顾 柑 套 模板 ， 并 介绍 一 种 没有 在 本 节 中 展示 的 
动作 _ 定义 动作 。 虽 然 使 用 动作 可 以 给 程序 员 带 来 方便 ， 但 是 本 节 
介绍 的 都 是 初级 的 模板 用 法 ， 它 们 并 不 能 最 大 限度 地 发 挥 模板 的 威 
力 。 为 了 解决 这 个 问题 ， 本 章 接 下 来 将 介绍 参数 、 变 量 和 管道 等 高 级 


模板 用 法 。 
54 参数、 变量 和 管道 
一 个 参 


参数 (argument) 就 是 模板 中 的 一 个 值 。 它 可 以 是 布尔 值 、 
整数 、 字 符 串 等 字面 量 ， 也 可 以 是 结构 、 结 构 中 的 一 个 字段 或 者 数组 


ja eek 参数 还 可 以 是 一 个 变量 、 一 个 方法 (这 个 方 
法 必须 只 返回 一 个 值 ， 或 者 只 返回 一 个 值 和 一 个 错误 ) 或 者 一 个 画 
数 。 最 后 ， 参 数 也 可 以 是 一 个 点 (. ) ， 用 于 表示 处 理 器 向 模板 引擎 传 

递 的 数据 。 


比如 说 ， 在 以 下 这 个 例子 中 ，arg 是 一 个 参数 : 


{{ if arg }} 


some content 


{{ end }} 


除了 参数 之 外 ， 用 户 还 可 以 在 动作 中 设置 变量 。 变 量 以 类 元 符号 
($) 开头 ， 就 像 这 样 : 


$variable := value 


初 看 上 去 ， 变 量 似乎 并 没有 什么 特别 天 的 用 处 ， 但 实际 上 它们 对 
动作 来 说 是 非常 重要 的 。 作 为 例子 ， 以 下 代码 展示 了 直 样 使 用 变量 去 
实现 迭代 动作 的 一 个 变种 : 


{{ range $key, $value := . }} 
The fo is {{ $key }} and the value is {{ $value }} 


{{ end }} 


在 这 个 例子 中 ， 点 (. ) 是 一 个 映射 ， 而 动作 range 在 迭代 这 个 
映射 的 时 候 ， 会 将 变量 $key 和 $value 分 别 初始 化 为 当前 被 迁 代 映射 
元 素 的 键 和 值 。 


模板 中 的 管道 (pipeline) 是 多 个 有 序 地 串联 起 来 的 参数 、 函 数 和 
方法 ， 它 的 工作 方式 和 语法 跟 Unix 的 管道 也 非 第 相似 : 


{{ p1 | p2 | p3 177 


这 里 的 p1、p2 和 p3 Awe Ras KA ° HELI RR 
参数 的 输出 传递 给 下 一 个 参数 ， 而 各 个 参数 之 间 则 使 用 | 分 隔 。 代 码 清 
单 5-13 展 示 了 一 个 管道 的 使 用 示例 。 


代码 清单 5-13 ”模板 中 的 管道 


<!DOCTYPE html> 
<html> 


<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf- 
g> 
<title>Go Web Programming</title> 


</head> 
<body> 
{{ 12.3456 | printf "%.2f" }} 
</body> 
</html> 


为 了 更 好 地 显示 内 容 ， 用 户 经 常 需要 在 模板 中 对 数据 进行 格式 
化 。 比 如 ， 在 代码 清单 5-13 所 示 的 例子 中 ， 我 们 想 要 在 显示 浮 点 数 的 时 
候 只 保留 两 位 小 数 精度 。 为 了 做 到 这 一 点 ， 我 们 可 以 使 用 
fmt .Sprintf 函数 或 者 模板 内 置 的 printf 了 芳 数 对 浮 点 数 进 行 格式 化 
(这 个 printf 画 数 实际 上 就 是 fmt .Sprintf 函数 的 别名 ) 。 


除 此 之 外 ， 我 们 还 通过 管道 将 数字 12 . 3456 传递 给 了 printf K 
数 ， 并 在 printf 函数 的 第 一 个 参数 中 指定 了 格式 指示 符 


(specifier) ， 最 终 ， 这 个 管道 将 返回 12 , 35 作为 结果 。 


虽然 管道 已 经 非常 强大 ， 但 它 还 不 是 模板 提供 的 最 为 强大 的 功 
能 ， 搂 下 来 的 一 下 要 介绍 的 函数 才 是 


5.5 KA 


EAZ BIITH, Goat A] LAT RRS: Gots! BA 
了 一 些 非 常 基础 的 函数 ， 其 中 包括 为 fmt .Sprint 的 不 同 变种 创建 的 
几 个 别名 函数 (fmt 包 的 文档 详细 地 列 出 了 这 些 别名 函数 ) ， 并 且 用 
尸 不 仅 可 以 使 用 模板 引擎 内 置 的 钞 数 ， 还 可 以 目 行 定义 目 己 想 要 的 函 
需要 注意 的 是 ，Go 的 模板 引擎 函数 都 是 受 限 制 的 : 尽管 这 些 函 数 
可 以 接受 任意 多 个 参数 作为 输入 ， 但 它们 只 能 返回 一 个 值 ， 或 者 返回 


一 个 值 和 一 个 错误 。 


o 


为 了 创建 一 个 自 定 义 模板 函数 ， 用 户 需 要 : 


(1) 创建 一 个 名 为 FuncMap 的 映射 ， 并 将 映射 的 键 设置 为 函数 
的 名 字 ， 而 映射 的 值 则 设置 为 实际 定义 的 函数 


(2) 将 FuncMap 与 模板 进行 绑 定 。 


证 我 们 来 看 一 个 创建 和 目 定义 函数 的 具体 例子 。 在 编写 Web 应 用 的 时 
候 ， 用 户 肖 第 需要 将 时 间 对 象 或 者 日 期 对 象 转 换 为 15O8601 格 式 的 时 间 
字符 串 或 者 日 期 字符 串 ， 又 或 者 将 ISO8601 格 式 的 字符 串 转 换 为 相应 的 


对 象 。 但 遗憾 的 是 ， 我 们 正在 使 用 的 库 并 没有 内 置 类 似 的 转换 函数 ， 
所 以 我 们 就 需要 像 代 码 清 单 5-14 展 示 的 那样 ， 目 行 创 建 这 些 函 数 。 


代码 清单 5-14 ”创建 模板 自 定 义 函 数 


package main 


import ( 
"net/http" 
"html/template" 
UL! time" 


) 


func formatDate(t time.Time) string { 
layout := "2006-01-02" 
return t.Format(layout ) 


} 


func process(w http.Responsewriter, r *http.Request) { 


funcMap := template.FuncMap { "fdate": formatDate } 
t := template.New("tmpl.htm1").Funcs(funcMap ) 

t, _ = t.ParseFiles("tmpl.html") 

t.Execute(w, time.Now() ) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


} 


这 段 程 序 首 先 定 义 了 一 个 名 为 formatDate 的 函数 ， 它 接受 一 个 
Time 结构 作为 输入 ， 然 后 以 “年 -月 -日 ?的 形式 返回 一 个 ISO8601 格 式 的 
FITE o 


在 之 后 的 处 理 器 中 ， 程 序 创建 了 一 个 变量 名 为 funcMap 的 
FuncMap 结构 ， 并 使 用 这 个 结构 将 名 字 fdate Rit FformatDate 


KA o RE, TEN template. New 函数 创建 了 一 个 名 为 

tmpl. html RI ° HA template. New 函数 会 返回 被 创建 的 模 
板 ， 所 以 程序 直接 以 串联 的 方式 调用 模板 的 Funcs 方法 ， 并 将 前 面 创 
建 的 funcMap 传递 给 模板 。 这 样 一 来 ，funcMap 与 模板 的 绑 定 就 完 
成 了 ， 于 是 程序 接 下 来 就 跟 往 常 一 样 ， 对 模板 文件 tmpl.html 进行 语 
法 分 析 。 最 后 ， 程 序 调 用 模板 的 Execute 方法 ， 并 将 
Responsewriter 以 及 当前 时 间 传 递 给 它 。 


再 次 提醒 ， 在 调用 ParseFiles 函数 时 ， 如 果 用 户 没有 为 模板 文 
件 中 的 模板 定义 名 字 ， 那 么 函数 将 使 用 模板 文件 的 名 字 作为 模板 的 儿 
字 。 与 此 同时 ， 在 调用 New 函数 创建 新 模板 的 时 候 ， 用 户 必须 传 入 一 
个 模板 名 字 ， 如 采用 户 给 定 的 模板 名 字 跟 前 面 分 析 模 板 时 通过 文件 名 
提取 的 模板 名 字 不 相同 ， 那 么 程序 将 返回 一 个 错误 。 


在 看 过 了 处 理 器 的 相关 代码 之 后 ， 现 在 让 我 们 来 看 看 如 何在 
tmpl.html 模板 中 使 用 前 面 定义 的 函数 ， 具 体 的 方法 如 代码 清单 5-15 
所 示 。 


代码 清单 5-15 ”通过 管道 使 用 自 定义 函数 


<html> 


<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
gs 
<title>Go Web Programming</title> 


</head> 
<body> 
<div>The date/time is {{ . | fdate }}</div> 
</body> 
</html> 


用 户 可 以 通过 几 种 不 同 的 方式 使 用 目 定 义 函 数 。 比 如 ， 代 码 清单 5- 
15 束 展示 了 如 何 通 过 模板 的 管道 特性 ， 将 当前 时 间 由 管道 传递 至 
Fdate 画 数 ， 并 娠 此 产生 图 5-8 所 示 的 输出 。 


Qoo < 127.0.0.1:8080/process 


The date/time is 2015-02-08 


图 5-8 ”使 用 自 定 义 函 数 格式 化 日 期 或 时 间 


除 此 之 外 ， 我 们 也 可 以 像 调 用 普通 画 数 一 样 ， 将 点 〈, ) 作为 参数 
传递 给 fdate 函数 ， 具 体 做 法 如 代码 清单 5-16 所 示 。 


代码 清单 5-16 ”通过 传递 参数 的 方式 使 用 和 目 定 义 函 数 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 


ens 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>The date/time is {{ fdate . }}</div> 
</body> 
</html> 


以 上 两 种 调用 方式 会 产生 相同 的 结果 ， 但 使 用 管道 比 直接 调用 画 
数 要 强大 和 灵活 得 多 。 如 琳 用 户 定 义 了 多 个 函数 ， 那 么 他 整 可 以 通过 
管道 将 一 个 函数 的 输出 传递 给 另 一 个 函数 作为 输入 ， 从 而 以 不 同 的 方 
式 组 合 使 用 这 些 男 数 ;， 尽管 普通 的 函数 调用 也 能 够 做 到 这 一 点 ， 但 使 
用 管道 可 以 产生 更 答 单 且 更 可 读 的 代码 。 


5.6 上下文 感 知 


Go 语言 的 模板 引擎 拥有 一 个 非常 有 趣 的 特性 一 一 它 可 以 根据 内 容 

所 处 的 上 下 文 改 变 其 显示 的 内 容 。 是 的 ， 你 没 看 错 。 根 据 内 容 在 文档 
中 所 处 的 位 置 ， 模 板 在 显示 这 些 内 容 的 时 候 将 对 其 进行 相应 的 修改 ， 

aa 话说 ，Go 的 模板 将 以 上 下 文 感知 (context-aware) 的 方式 显示 内 
。 那么 这 个 特性 有 什么 用 ， 我 们 又 会 在 什么 地 方 用 到 这 个 特性 呢 ? 


上 下 文 感知 的 一 个 显而易见 的 用 途 就 是 对 被 显示 的 内 容 实施 正确 
的 转 义 (escape) : 这 意味 着 ， 如 果 模 板 显 示 的 是 HTML 格 式 的 内 容 ， 
那么 模板 将 对 其 实施 HTML 转 义 ; 如 果 模 板 显 示 的 是 JavaScript 格 式 的 
内 容 ， 那 么 模板 将 对 其 实施 JavaScript 转 义 ; 诸如 此 类 。 除 此 之 外 ，Go 
模板 引 敬 还 可 以 识别 出 内 容 中 的 URL 或 者 CSS 样 式 。 代 码 清 单 5-17 展 示 
了 一 个 上 下 文 感知 特性 的 使 用 例子 。 


代码 清单 5-17 为 了 展示 模板 中 的 上 下 文 感知 特性 而 设置 的 处 理 器 


package main 


import ( 
"net/http" 
"html/template" 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
content := “I asked: <i>"What's up?"</i>. 
t.Execute(w, content) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server .ListenAndServe( ) 


IX SAREE ERE I XÆFM ABI asked: <i>"What's 
up?"</i> ， 它 包含 了 几 个 需要 事先 转 义 的 特殊 字符 ， 代 码 清 单 5-18 展 
示 了 与 这 个 处 理 器 相对 应 的 模板 文件 tmpl.html 。 


代码 清单 5-18 ”上 下 文 感知 模板 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 


<div>{{ . }}</div> 
<div><a href="/{{ . }}">Path</a></div> 
<div><a href="/?q={{ . }}">Query</a></div> 
<div><a onclick="f('{{ . }}')">Onclick</a></div> 
</body> 
</html> 


正如 代码 所 示 ， 这 个 模板 将 传 入 的 参数 放 到 ree 同 
的 位 置 ， 并 且 每 个 位 置 都 使 用 了 <div> 标签 对 其 进行 包 于 。 如 果 我 们 


使 用 4.1.4 节 介绍 的 方法 ， 通 过 cURL 获取 未 经 改动 的 原始 HTML 文 件 ， 
那么 我 们 将 得 到 以 下 结果 : 


curl -i 127.0.0.1:8080/process 
HTTP/1.1 200 OK 

Date: Sat, 07 Feb 2015 05:42:41 GMT 
Content-Length: 505 

Content-Type: text/html; charset=utf-8 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 


8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>I asked: &lt;i&gt;&#34;What&#39;s up?&#34;&lt;/i&gt;</div> 
<div> 
<a href="/1%20asked :%20%3ci%3e%22what%27s%20up?%22%3c/i%3e"> 
Path 
</a> 
</div> 
<div> 
<a href="/? 
q=I%20asked%3a%20%3ci%3e%22what%27s%20up%3f%22%3c%2fi%3e"> 
Query 
</a> 
</div> 
<div> 
<a onclick="f('I asked: \x3ci\x3e\x22What\x27s up? 
\xX22\x3c\/1i\x3e!' ) "> 
Onclick 
</a> 
</div> 
</body> 
</html> 


这 个 结果 看 上 去 有 点 儿 复 杂 ， 表 5-1 展 示 了 结果 HTML 与 输入 原文 
之 间 的 区 别 。 


表 5-1 Go 模板 中 的 上 下 文 感知 : 根据 动作 所 在 的 位 置 ， 同 样 的 内 容 输入 将 产生 不 同 的 输出 结 


Ea an 
= Hor 


I asked: &lt;i&gt;&#34;What&#39;s up?&#34;&lt;/i&gt; 


<a href="/{{ . p "> I%20asked:%20%3ci%3e%22What%27s%20up?%22%3c/i%3e 
<a href="/?q={{ . }}"> | 1%20asked%3a%20%3Cc1i%3e%2 2What%27S%20UP%3F%22%3C%2F1%3e 
<a onclick="{{ . }}"> |I asked: \x3ci\x3e\x22What\x27s up?\x22\x3c\/1i\x3e 


上 下 文 感知 特性 主要 用 于 实现 目 动 的 防御 编程 ， 并 且 它 使 用 起 来 
非常 方便 。 通 过 根据 上 下 文 对 内 容 进 行 修改 ，Go 模 板 可 以 防止 某 些 明 
显 并 且 低 级 的 编程 错误 。 比 如 ， 接 下 来 鸭 内 容 丈 会 回 我 们 展示 如 何 使 
用 上 下 文 感知 特性 来 防御 XSS (cross-site Scripting， 跨 站 脚本 ) 攻击 。 


5.6.1 防御 XSS 攻 击 


持久 性 XSS 漏 洞 (persistent XSS vulnerability) 是 一 种 常见 的 XSS 
攻击 方式 ， 这 种 攻击 是 由 于 服务 器 将 攻击 者 存储 的 数据 原原本本 地 显 
示 给 其 他 用 户 所 致 的 。 举 个 例子 ， 如 果 有 一 个 存在 持久 性 XSS 漏 洞 的 论 
坛 ， 它 允许 用 户 在 论坛 上 面 发 布 帖子 或 者 回复 ， 并 且 其 他 用 户 也 可 以 
阅读 这 些 帖 子 以 及 回复 ， 那 么 攻击 者 就 可 能 会 在 他 发 布 的 内 容 中 引入 


带 有 <script> 标签 的 代码 。 因 为 论坛 即使 在 内 容 带 有 <script> 标 
签 的 情况 下 ， 仍 然 会 原原本本 地 向 用 户 显示 这 些 内 容 ， 所 以 用 户 将 在 
宣 不 知情 的 情况 下 ， 使 用 自己 的 权限 去 执行 攻击 者 发 布 的 恶意 代码 。 
预防 这 一 攻击 的 常见 方法 就 是 在 显示 或 者 存储 用 户 传 入 的 数据 之 前 ， 
对 数据 进行 转 义 。 但 正如 很 多 漏洞 以 及 bug 一 样 ， 持 久 性 XSS 漏 洞 往往 
会 由 于 人 为 的 因素 而 出 现 。 


为 了 说 明 如 何 防御 持久 性 XSS 漏 洞 ， 我 们 需要 用 到 一 些 HIML 表 单 
数据 。 这 一 次 ， 比 起 直接 将 数据 硬 编码 到 处 理 器 里 面 ， 更 好 的 选择 是 
使 用 第 4 章 学 到 的 HTML 表 单 知 识 ， 创 建 一 个 代码 清单 5-19 所 示 的 
HTML 表 单 。 这 个 表单 允许 我 们 向 Web 应 用 发 送 数 据 ， 并 将 其 存储 在 
form. html 文件 中 。 


代码 清单 5-19 ”用 于 实施 XSS 攻 击 的 表单 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset =utf - 
" 
> 


<title>Go Web Programming</title> 
</head> 
<body> 
<form action="/process" method="post"> 
Comment: <input name="comment" type="text"> 
<hr/> 
<button id="submit">Submit</button> 
</form> 
</body> 
</html> 


接着 ， 为 了 处 理 来 自 HTML 表 单 的 数据 ， 我 们 需要 对 处 理 器 做 相应 
的 修改 ， 如 代码 清单 5-20 所 示 。 


代码 清单 5-20 测试 XSS 攻 击 


package main 


import ( 
"net/http" 
"html/template" 

) 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.htm1l") 
t.Execute(w, r.FormValue("comment") ) 


} 


func form(w http.Responsewriter, r *http.Request) { 


t, _ := template.ParseFiles("form.html") 
t.Execute(w, nil) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
http.HandleFunc("/form", form) 
server .ListenAndServe( ) 


最 后 ， 为 了 让 XSS 攻 击 的 测试 结果 可 以 更 好 地 显示 出 来 ， 我 们 需 
修改 tmp1.html 模板 文件 ， 如 代码 清单 5-21 所 示 。 


代码 清单 5-21 ”修改 后 的 tmpl .html 模板 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 


8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>{{ . }}</div> 
</body> 


</html> 


现在 ， 编 译 并 启动 修改 后 的 服务 器 ， 然 后 访问 
http:/127.0.0.1:8080/form。 接 春 像 图 5-9 所 示 的 那样 ， 将 以 下 内 容 输入 
到 表单 的 文本 框 里 面 ， 然 后 按 下 Submit 按 钮 


<script>alert('Pwnd!');</script> 


对 于 那些 不 过 滤 用 户 输入 并 且 在 web 页 面 上 直接 显示 用 户 输入 的 模 
板 引 警 来 说 ， 执 行 图 5-9 所 示 的 操作 将 会 显示 一 条 提示 信息 ， 这 也 意味 
着 攻击 者 可 以 让 网 站 上 的 其 他 用 户 执行 任意 可 能 的 攻击 代码 。 与 此 相 
反 ， 正 如 我 们 之 前 提 到 的 那样 ， 即 使 程序 员 志 了 对 用 户 的 输入 进行 过 
滤 ，Go 的 模板 引擎 也 会 在 显示 用 户 输入 时 将 其 转换 为 转 义 之 后 的 
HTML ， 以 此 来 避免 可 能 会 出 现 的 问题 ， 图 5-10 证 实 了 这 一 点 。 


eoo < > 127.0.0.1:8080/form 


Comment: <script>alert(‘Pywnd!’);</script> 


Submit 


图 5-9 ”用 于 实施 XSS 攻 击 的 表单 


@®oee < 127.0.0.1:8080/process 


<scriptalert(Pwnd!');</script> 


图 5-10 多谢 Go 的 模板 引擎 ， 原 本 会 导致 漏洞 的 用 户 输入 已 经 被 转 义 了 


查看 这 个 页 面 的 源 代码 将 会 看 到 以 下 结果 : 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8"> 
<title>GowebProgramming</title> 


</head> 
<body> 
<div>&lt;script&gt;alert(&#39; Pwnd!&#39; );&lt;/script&gt ;</div> 
</body> 
</html> 


上 下 文 感知 功能 不 仅 能 够 自动 对 HTML 进 行 转 义 ， 它 还 能 够 防止 基 
于 JavaScript、CSS 甚 至 URL 的 XSS 攻 击 。 那 么 这 是 否 意味 着 我 们 只 要 使 
用 Go 的 模板 引 警 就 可 以 无 忧 无 虑 地 进行 开发 了 呢 ? 并 非 如 此 ， 上 下 文 
感知 虽然 很 方便 ， 但 它 并 非 灵 丹 妙药 ， 而 且 有 不 少 方法 可 以 绕 开 上 下 
文 感知 。 实 际 上 ， 如 果 需 要 ， 用 户 是 可 以 完全 不 使 用 上 下 文 感知 特性 
的 。 


5.6.2 ”不 对 HTML 进行 转 义 


如 果真 的 想 要 允许 用 户 输 入 HTML 代 码 或 者 JavaScript 代 码 ， 并 在 
显示 内 容 时 执行 这 些 代码 ， 可 以 使 用 Go 提供 的 “不 转 义 HTML” 机 制 |: 
只 要 把 不 想 被 转 义 的 内 容 传 给 template .HTML KZ, R5 [RER 
会 对 其 进行 转 义 。 作 为 例子 ， 让 我 们 对 之 前 展示 过 的 处 理 器 做 一 些小 
修改 : 


func process(w http.Responsewriter, r *http.Request) { 
t, := template.ParseFiles("tmpl.html") 


t.Execute(w, template.HTML(r.FormValue("comment") ) ) 


} 


注意 ， 在 这 个 修改 后 的 处 理 器 画 数 中 ， 程 序 通过 类 型 转换 
(typecast) 将 表单 中 的 评论 值 转换 成 了 template .HTML 类 型 。 


现在 ， 重 新 编译 并 运行 这 个 服务 器 ， 然 后 再 次 尝试 实施 XSS 攻 击 。 
攻击 产生 的 结果 将 根据 用 户 使 用 的 浏 哎 絮 而 是 ， 如 采用 户 使 用 的 十 
Chrome ` Safari > IESE LA EIRA ASIEN bias, ILA ABRS BE 
一 一 用 户 将 看 到 一 个 空白 的 页 面 ;， 但 如 琳 用 户 使 用 的 是 Firefox， 那 么 
用 户 将 会 看 到 图 5-11 所 示 的 画面 。 


因为 IE、Chrome 和 Safari 在 默认 情况 下 都 能 够 防御 某 些 特定 类 型 的 
XSS 攻 击 ， 所 以 我 们 的 XSS 攻 击 在 这 3 个 浏 贤 右上 都 没有 能 够 成 功 实 
施 ， 与 此 相反 ， 因 为 Firefox 并 不 具备 内 置 的 XSS 防 御 功 能 ， 所 以 我 们 在 
Firefox] ar CDHE T XSS ° 


FRR, AP te ay URIE AARMA FY IES I A 
BI) 92 AFF RATT Pla by. EH BE X-XSS-Protection FILEN bas A SAY XSS 
防御 功能 ， 就 像 这 样 : 


func process(w http.Responsewriter, r *http.Request) { 
w.Header().Set("X-XSS-Protection", "0") 


t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, template.HTML(r.FormValue("comment") ) ) 


eee AS Go Web Programming x \ + 


€ | @ 127.0.0.1:8080/process 


Transferring data from 127.0.0.1... 


图 5-11 XSS 攻 击 成 功 


现在 ， 如 果 再 次 党 试 实 施 XSS 攻 击 ， 那 么 你 将 会 在 IE、Chrome 和 
Safari 上 看 到 与 Firefox 相 同 的 攻击 效果 。 


5.7 KERN 


本 章 到 目前 为 止 已 经 介绍 了 Go 模板 引擎 的 不 少 特性 ， 在 继续 了 解 
更 多 特性 之 前 ， 我 们 需要 先 学 习 一 下 如 何在 Web 应 用 中 使 用 布局 。 


所 谓 的 布局 (layout) ， 指 的 是 Web 设 计 中 可 以 重复 应 用 在 多 个 页 
面 上 的 固定 模式 。 为 了 构建 协调 一 致 的 用 户 界 面 ，Web 应 用 生肖 需要 展 
示 一 些 相似 的 页 面 ， 因 此 Web 应 用 也 会 经 冰 用 到 布局 。 比 如 说 ， 很 多 
Web 应 用 都 拥有 相应 的 头 部 染 单 ， 以 及 提供 服务 瑚 状态 、 版 权 声 明 、 联 
系 方式 等 附加 信息 的 尾部 栏 ， 而 其 他 一 些 Web 应 用 可 能 会 在 屏幕 的 左 侧 
提供 导航 栏 又 或 者 多 级 导航 菜单 。 不 难 猜 出 ， 这 些 布 局 实际 上 都 可 以 
(EH REISE, 


BUTI) E ENA E OES, (EEA 
这 种 方法 来 开发 复杂 的 Web 应 用 ， 不 仅 需 要 将 大 量 代 码 硬 编码 到 处 理 器 
里 面 ， 还 需要 创建 大 量 的 模板 文件 ， 而 引发 这 一 问题 的 原因 跟 我 们 使 
用 模板 的 方式 有 关 。 


正如 之 前 所 说 ， 我 们 可 以 通过 包含 动作 ， 在 一 个 模板 里 面包 含 为 
一 个 模板 : 


{{ template "name" . }} 


其 中 动作 的 参数 name 束 是 被 包 侣 模板 的 名 字 ， 并 且 这 个 名 字 还 是 一 个 
字符 串 常量 。 这 意味 着 如 果 我 们 继续 像 之 前 一 样 ， 使 用 文件 名 作为 模 
板 名 ， 那 么 因为 每 个 页 面 都 拥有 它们 各 目的 布局 模板 文件 ， 所 以 程序 


最 终 将 无 法 拥有 任何 可 共用 的 公共 布局 ， 而 这 种 做 法 跟 构 建 布局 的 想 
法 正好 是 相 背 的 。 比 如 说 ， 对 于 代码 清单 5-22 所 示 的 模板 文件 ， 我 们 就 
不 能 把 它 用 作 公共 的 布局 模板 文件 。 


代码 清单 5-22 ”无 效 的 模板 布局 文件 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset =utf - 
8"5 
<title>Go Web Programming</title> 


</head> 
<body> 
{{ template "content.html" }} 
</body> 
</html> 


出 现 这 种 问题 的 根源 在 于 我 们 实际 上 并 没有 以 正确 的 方式 使 用 Go 
模板 引擎 。 尺 管 我 们 可 以 让 每 个 模板 文件 都 只 定义 一 个 模板 ， 并 将 模 
板 文件 的 名 字 用 作 模 板 的 名 字 ， 但 实际 上 ， 我 们 也 可 以 通过 定义 动作 

(define action) ， 在 模板 文件 里 面 显 式 地 定义 模板 ， 就 像 代码 清单 5- 
23 所 示 的 那样 。 


代码 清单 5-23” 显 式 地 定义 一 个 模板 


{{ define "layout" }} 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset =utf - 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
{{ template "content" }} 
</body> 


</html> 


{{ end }} 


这 个 文件 以 一 个 {{ define "layout" }} 标签 作 开 头 ， 并 以 一 
个 {{ end }} 标签 结尾 ， 而 介 于 这 两 个 标签 之 间 的 内 容 束 是 layout 
模板 的 定义 。 与 此 同时 ， 通 过 使 用 另 一 个 定义 动作 ， 我 们 还 可 以 在 这 
个 文件 里 面 再 多 创建 一 个 模板 。 换 名 话说， 我 们 可 以 像 代 人 码 清单 5-24 所 
示 的 那样 ， 在 同一 个 模板 文件 里 面 定义 多 个 不 同 的 模板 。 


代码 清单 5-24 ”在 一 个 模板 文件 里 面 定 义 多 个 模板 


{{ define "layout" }} 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
{{ template "content" }} 
</body> 
</html> 


{{ end }} 


{{ define "content" }} 


Hello World! 


{{ end }} 
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代码 清单 5-25 ”使 用 显 式 定义 的 模板 


func process(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("layout.htm1") 


t.ExecuteTemplate(w, "layout", "") 


} 


分 析 模 板 的 方法 跟 之 前 介绍 过 的 一 样 ， 但 是 这 次 在 执行 模板 的 时 
候 ， 程 序 需 要 显 式 地 使 用 ExecuteTemplate 方法 ， 并 把 待 执行 的 
layout 模板 的 名 字 用 作 方 法 的 第 二 个 参数 。 因 为 layout ERRET 
content 模板 ， 所 以 程序 只 需要 执行 ]ayout 模板 就 可 以 在 浏览 器 中 
得 到 content 模板 产生 的 Hello World! 输出 了 。 通 过 使 用 cURL 获 
取 模 板 输出 的 实际 HTML 文 件 ， 我 们 将 看 到 以 下 结 


> curl -i http://127.0.0.1:8080/process 
HTTP/1.1 200 OK 

Date: Sun, 08 Feb 2015 14:09:15 GMT 
Content-Length: 187 

Content-Type: text/html; charset=utf-8 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf - 
8"> 
<title>Go Web Programming</title> 
</head> 
<body> 


Hello World! 


</body> 
</html> 
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可 以 在 不 同 的 模板 文件 里 面 定 义 同名 的 模板 。 作 为 例子 ， 让 我 们 首先 
移 除 layout .html 文件 中 现 有 的 content 模板 定义 ， 然 后 分 别 在 代 


码 清 单 5-26 和 代码 清单 5-27 所 示 的 red_hello.html 文件 和 
blue_hello.html 文件 中 重新 定义 content 模板 。 


代码 清单 5-26 red_hello.html 


{{ define "content" }} 


<hi style="color: red;">Hello World!</h1> 


{{ end }} 


代码 清单 5-27 blue_hello.html 


{{ define "content" }} 


<hi style="color: blue;">Hello World!</h1> 


{{ end }} 


代码 清单 5-28 展 示 了 修改 之 后 的 处 理 器 ， 它 同 我 们 演示 了 应 该 如 何 
使 用 在 不 同 模板 文件 中 定义 的 两 个 content 模板 。 


代码 清单 5-28 ”处 理 器 使 用 在 不 同 模板 文件 中 定义 的 同名 模板 


func process(w http.Responsewriter, r *http.Request) { 
rand.Seed(time.Now().Unix() ) 
var t *template.Template 
if rand.Intn(10) > 5 { 
t, _ = template.ParseFiles("layout.html", "red hello.html") 


} else { 


t, _ = template.ParseFiles("layout.html", "blue hello.html") 
} 


t.ExecuteTemplate(w, "layout", "") 


这 个 处 理 器 会 根据 生成 的 随机 数 ， 决 定 对 red_he11o.,htm1 和 
blue_hello. html 这 两 个 模板 文件 中 的 哪 一 个 进行 语法 分 析 。 当 处 
理 器 像 之 前 一 样 执 行 包 含 了 content 模板 的 layout 模板 时 ， 被 随机 
选中 的 那个 模板 文件 中 定义 的 content 模板 就 会 被 执行 。 因 为 
red_hello.html 和 blue_hello.,html 这 两 个 模板 文件 都 定义 了 
content 模板 ， 所 以 它们 中 的 哪 一 个 被 随机 选中 了 进行 语法 分 机 ， 被 
分 析 文 件 中 定义 的 content 模板 就 会 被 执行 。 换 句 话 说 ， 我 们 可 以 在 
维持 “layout 模板 包含 content 模板 ”这 一 关系 不 变 的 情况 下 ， 通 过 
对 不 同 的 模板 文件 进行 语法 分 析 来 达到 改变 输出 结果 的 目的 。 

现在 ， 如 采 我 们 重新 编译 并 启动 修改 后 的 服务 器 ， 然 后 通过 浏览 
回 对 其 进行 访问 ， 那 么 我 们 将 会 随机 看 到 监 色 或 者 红色 的 He11o 
World! 输出 ， 束 像 图 5-12 所 示 的 那样 。 


eee < 127.0.0.1:8080/process e Ü 


Hello World! 


图 5-12 ”能 够 随机 切换 内 容 的 模板 


5.8 通过 块 动作 定义 默认 模板 


Go 1.6 引 入 了 一 个 新 的 块 动作 (block action) ， 这 个 动作 允许 用 户 
定义 一 个 模板 并 且 立 即使 用 。 块 动作 看 上 去 是 下 面 这 个 样子 的 : 


{{ block arg }} 


Dot is set to arg 


{{ end }} 


为 了 更 好 地 了 解 块 动作 的 使 用 方法 ， 我 们 将 使 用 块 动作 重新 实现 
上 一 节 展 示 过 的 例子 ， 并 在 处 理 器 没有 指定 特定 的 模板 时 ， 默 认 展 示 
蓝 色 的 Hello World 模 板 。 代 码 清单 5-29 展 示 了 修改 之 后 的 处 理 器 ， 正 如 
加 钥 的 代码 行 所 示 ， 处 理 器 的 else 块 将 不 再 同时 分 析 layout .html 
文件 和 blue_hello.html 文件 ， 而 是 只 分 析 layout .html 文 件 。 


代码 清单 5-29 ”只 对 layout .html 进行 语法 分 析 


func process(w http.Responsewriter, r *http.Request) { 
rand.Seed(time.Now().Unix()) 
var t *template.Template 
if rand.Intn(10) > 5 { 
t, _ = template.ParseFiles("layout.html", "red hello.html") 
} else { 
t, _ = template.ParseFiles("layout.html1") 


} 


t.ExecuteTemplate(w, "layout", "") 
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的 情况 。 为 了 解决 这 个 问题 ， 我 们 需要 像 代 码 清单 5-30 所 示 的 那样 ， 在 
layout .html 模板 文件 中 通过 块 动作 定义 content 模板 ， 并 将 其 用 
作 默 认 的 content 模板 。 


代码 清单 5-30 ”通过 块 动作 添加 默认 的 content 模板 


{{ define "layout" }} 


< html> 
< head> 
< meta http-equiv="Content-Type" content="text/html; 
charset=utf-8"> 
< title>Go Web Programming< /title> 
< /head> 
< body> 
{{ block "content" . }} 


< hi style="color: blue;">Hello World!< /hi1> 


{{ end }} 


< /body> 
< /html> 


{{ end }} 


块 动作 能 够 高 效 地 定义 一 个 content 模板 ， 并 将 它 放 置 到 
layout 模板 里 面 。 当 layout 模板 被 执行 时 ， 如 果 模 板 引擎 没有 找到 
可 用 的 content 模板 ， 那 么 它 束 会 使 用 块 动作 中 定义 的 content {R 
板 。 


在 最 近 的 这 几 章 ， 我 们 学 习 了 如 何 接收 请 求 ， 如 何 处 理 请 求 ， 以 
及 如 何 生成 用 于 啊 应 请 求 的 内 容 ， 而 在 接 下 来 的 一 章 ， 我 们 将 要 学 习 


如 何 通过 Go 语言 将 数据 存储 到 内 存 、 文 件 或 者 数据 库 里 面 。 


5.9 ”小结 


在 Web 应 用 中 ， 模 板 引擎 会 把 模板 和 数据 进行 合并 ， 生 成 将 要 返回 
给 客户 端的 HIML 。 

Go 的 标准 模板 引擎 定义 在 html/template 包 当 中 。 

Go 模板 引擎 的 工作 方式 就 是 对 一 个 模板 进行 语法 分 析 ， 接 着 在 执 
行 这 个 模板 的 时 候 ， 将 一 个 ResponseWwriter 以 及 一 些 数据 传 
递 给 它 。 被 调用 的 模板 引擎 会 对 传 入 的 已 分 析 模 板 以 及 数据 进行 
合并 ， 然 后 把 合并 的 结果 传递 给 ResponseWriter 。 

Go 的 模板 拥有 一 系列 丰富 多 样 并 且 威 力 强 大 的 动作 ， 这 些 动 作 整 
是 一 系列 命令 ， 它 们 可 以 告诉 模板 应 该 以 何 种 方式 与 数据 合并 。 
除了 动作 之 外 ， 模 板 还 可 以 包含 参数 、 管 道 和 变量 : 其 中 参数 用 
于 表示 模板 中 的 数据 值 ， 管 道 用 于 串联 起 多 个 参数 和 函数 ， 至 于 
变量 则 会 作为 动作 的 组 件 而 存在 。 

Go 拥有 一 系列 受 限 的 模板 函数 。 此 外 ， 通 过 创建 一 个 函数 映射 并 
将 它 与 模板 进行 绑 定 ， 用 户 也 可 以 创建 出 自己 的 模板 函数 。 

Go 的 模板 引擎 可 以 根据 数据 所 在 的 位 置 改 变数 据 的 显示 方式 ， 这 
种 上 下 文 感知 特性 能 够 有 效 地 防御 XSS 攻 击 。 

人 们 在 设计 一 个 拥有 一 致 外 观 和 使 用 感受 的 Web 应 用 时 ， 常 常会 用 
到 Web 布 局 ，Go 可 以 使 用 般 套 模板 来 实现 Web 布 局 。 


第 6 章 ”存储 数据 


本 章 主要 内 容 


。 使 用 结构 进行 内 存 存储 

。 使 用 CSV 和 gob 二 进 制 文件 进行 文件 存储 
。 使 用 SQL 进行 关系 数据 库存 储 

。 Go 与 SQL 映射 器 


本 书 在 第 2 章 引 入 了 数据 持久 化 这 一 概念 ， 并 人 简单 地 介绍 了 如 何 将 
数据 持久 化 到 PostgreSQL 这 个 关系 数据 库 中 。 本 章 将 会 继续 深入 讨论 
数据 持久 化 这 一 主题 ， 并 说 明 如 何 才 能 将 数据 存储 到 内 存 、 文 件 、 关 
系数 据 库 以 及 NoSQL 数 据 库 中 。 


尽管 数据 持久 化 从 技术 上 来 说 并 不 属于 Web 应 用 编程 的 范畴 ， 但 
因为 绝 大 部 分 Web 应 用 都 会 以 某 种 形式 存储 数据 ， 所 以 数据 持久 化 是 
除了 模板 和 处 理 右 这 两 大 文 柱 之 外 ， 任 何 Web 应 用 都 必 不 可 少 的 第 三 
At 
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。 在 程序 运行 时 ， 将 数据 存储 到 内 存 里 面 ; 
。 将 数据 存储 到 文件 系统 的 文件 里 面 ; 
。 通过 服务 器 程序 前 端 ， 将 数据 存储 到 数据 库 里 面 。 


在 本 章 中 ， 我 们 将 会 分 别 通过 以 上 这 3 种 手段 ， 使 用 Go 对 数据 进 
行 访 问 ， 并 对 数据 执行 俗称 CRUD 的 创建 、 获 取 、 更 新 和 删除 这 4 个 操 
作 。 


6.1 内 存 存储 


本 节 所 说 的 内 存 存储 指 的 是 将 数据 存储 在 运行 中 的 应 用 里 面 ， 并 
在 应 用 运行 的 过 程 中 使 用 这 些 数据 ， 而 不 是 说 将 数据 存储 到 内 存 数据 
库 里 面 。 将 数据 存储 在 数据 结构 里 面 是 实现 内 存 存储 的 常见 手段 ， 对 
于 Go 语言 来 说 ， 这 意味 着 使 用 数组 、 切 片 、 映 射 和 结构 来 存储 数据 。 


存储 数据 这 一 操作 本 身 是 非常 简单 的 ， 用 户 只 需要 创建 相应 的 结 
构 、 切 片 和 映射 就 可 以 了 。 但 如 果 我 们 更 加 深入 地 思考 这 个 问题 束 会 
发 现 ， 程 序 最 终 操 作 的 将 不 是 一 个 个 单独 的 结构 ， 而 是 一 系列 由 容 屁 
(container) 包 襄 的 多 个 结构 :这 些 容器 既 可 以 是 数组 、 切 片 和 了 映 
射 ， 也 可 以 是 栈 、 树 、 队 列 以 及 其 他 任意 类 型 的 数据 结构 。 
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有 趣 的 问题 。 比 如 说 ， 代 码 清单 6-1 就 展示 了 一 个 使 用 映射 作为 结构 容 
an HPI ° 


代码 清单 6-1 在 内 存 里 面 存 储 数据 


package main 


import ( 
"Fmt" 


) 


type Post struct { 


Id int 
Content string 
Author string 


} 


var PostById map[int]*Post 
var PostsByAuthor map[string][]*Post 


func store(post Post) { 

PostById[post.Id] = &post 

PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], 
&post ) 
} 


func main() { 


PostById = make(map[int]*Post) 
PostsByAuthor = make(map[string][]*Post) 


posti := Post{Id: 1, Content: "Hello World!", Author: "Sau 
Sheong"} 

post2 : 
"Pierre"} 

post3 := Post{Id: 3, Content: "Hola Mundo!", Author: "Pedro"} 

post4 := Post{Id: 4, Content: "Greetings Earthlings!", Author: 

="Sau Sheong"} 

store(post1) 

store(post2) 

store(post3) 

store(post4) 


Post{Id: 2, Content: "Bonjour Monde!", Author: 


fmt .Println(PostById[1] ) 
fmt .Println(PostById[2] ) 


for _, post := range PostsByAuthor["Sau Sheong"] { 
fmt.Println(post ) 

} 

for _, post := range PostsByAuthor["Pedro"] { 
fmt.Println(post ) 


} 


这 个 程序 会 使 用 Post 结构 来 表示 论坛 应 用 中 的 帖子 ， 并 将 该 结 


构 存 储 在 内 存 里 面 : 


type Post struct { 
Id int 
Content string 
Author string 


} 


Post 结构 中 最 主要 的 数据 是 帖子 的 内 容 ， 用 户 也 可 以 通过 帖子 
的 唯一 ID 或 者 帖子 作者 的 名 字 来 获取 帖子 。 程 序 会 通过 将 一 个 代表 由 
子 的 键 映射 至 实际 的 Post 结构 来 存储 多 个 帖子 。 为 了 提供 两 种 不 同 
的 方法 来 访问 帖子 ， 程 序 分 别 使 用 了 两 个 map 来 创建 两 种 不 同 的 映 
at: 


var PostById map[int]*Post 
var PostsByAuthor map[string][]*Post 


程序 使 用 了 两 个 变量 来 存储 映射 ， 其 中 PostById 变量 会 将 帖子 
的 唯一 ID 映射 至 指向 帖子 的 指针 ， 而 PostsByAuthor 变量 则 会 将 作 
者 的 名 字 映 射 至 一 个 切片 ， 这 个 切片 可 以 包含 多 个 指向 帖子 的 指针 。 
注意 ， 无 论 是 PostById 还 是 PostsByAuthor ， 它 们 映射 的 都 是 指 
向 帖子 的 指针 而 不 是 帖子 本 身 。 这 样 做 可 以 确保 程序 无 论 是 通过 ID 还 
是 通过 作者 的 名 字 来 获取 帖子 ， 得 到 的 都 是 相同 的 帖子 ， 而 不 是 同一 
帖子 的 不 同 副本 。 


在 此 之 后 ， 程 序 定 义 了 用 于 存储 帖子 的 store Way: 


func store(post Post) { 

PostById[post.Id] = &post 

PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], 
&post ) 


| 

store 函数 会 将 一 个 指 回 帖子 的 指针 分 别 存储 到 PostById 变量 
和 PostsByAuthor 变量 里 面 。 紧 接着 ， 在 main( ) KAEH, FF 
创建 了 多 个 将 要 被 存储 的 帖子 ， 这 个 过 程 唯一 要 做 的 就 是 创建 多 个 
Post 结构 的 实例 : 


posti 
Sheong" 
post2 Post{Id: Content: "Bonjour Monde!", Author: "Pierre"} 
post3 Post{Id: Content: "Hola Mundo!", Author: "Pedro"} 
post4 := Post{Id: Content: "Greetings Earthlings!", Author: 
"Sau Sheong"} 


Post{Id: Content: "Hello World!", Author: "Sau 
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接着 程序 会 调用 前 面 定 义 的 store 函数 ， 把 这 些 帖 子 一 一 存储 起 
来 : 


store(post1) 
store(post2) 
store(post3) 
store(post4) 


如 果 运 行 这 个 程序 ， 我 们 将 会 看 到 以 下 输出 : 


Hello World! Sau Sheong} 
Bonjour Monde! Pierre} 
Hello World! Sau Sheong} 


Greetings Earthlings! Sau Sheong} 
Hola Mundo! Pedro} 


注意 ， 无 论 程序 是 通过 帖子 的 ID 还 是 帖子 的 作者 获取 帖子 ， 最 终 
得 到 的 都 是 同一 个 帖子 。 


这 个 例子 看 上 去 非常 简单 直接 ， 甚 至 可 以 说 有 氮 儿 简单 过 头 了 。 
我 们 之 所 以 要 学 习 怎 样 将 数据 存储 在 内 存 里 面 ， 是 因为 人 们 在 构建 
Web 应 用 的 时 候 ， 第 闻 会 像 第 2 章 展示 的 那样 ， 从 一 开始 束 使 用 关系 数 
据 库 ， 然 后 在 进行 性 能 扩展 的 时 候 ， 才 认识 到 目 己 需要 将 数据 库 返 回 
的 结果 缓存 起 来 以 提高 性 能 。 正 如 本 章 接 下 来 要 介绍 的 内 容 所 示 ， 对 
数据 进行 持久 化 的 绝 大 部 分 手段 都 会 以 这 样 或 那样 的 形式 使 用 结构 ， 
在 学 完 本 市 介绍 的 方法 之 后 ， 我 们 区 ® 可 以 在 进行 性 能 扩展 的 时 候 ， 通 
过 重 构 代 码 来 将 缓存 数据 存储 在 内 存 里 面 ， 而 不 一 定 非得 要 使 用 类 似 
Redis 那 样 的 外 部 内 存 数据 库 。 


因为 将 数据 存储 到 结构 里 面 对 数 据 存储 操作 是 一 种 非常 重要 的 重 
现 手 段 ， 所 以 本 章 以 及 后 续 章 节 还 会 继续 提 及 这 一 技术 。 


6.2 ”文件 存储 


因为 内 存 存储 不 需要 访问 硬盘 ， 所 以 相关 操作 通常 都 会 以 风 驰 电 
学 般 的 速度 完成 。 但 内 存 存 储 有 一 个 不 容 忽视 的 缺点 ， 那 吏 是 ， 存 储 
在 内 存 中 的 数据 并 不 是 持久 化 的 。 如 采 你 的 计算 机 或 者 程序 可 以 永远 
也 不 关闭 ， 又 或 者 你 的 数据 像 缓存 一 样 即使 丢失 了 也 无 所 谓 ， 那 么 这 
个 缺点 对 你 来 说 是 无 伤 大 雅 的 ;但 很 多 时 候 ， 即 使 是 对 于 缓存 数据 来 
说 ， 我 们 还 是 和 希望 数据 可 以 在 计算 机 关闭 或 者 程序 关闭 之 后 继续 存 
在 。 实 现 数据 持久 化 有 好 几 种 不 同 的 方式 可 选 ， 其 中 最 曾 见 的 葛 过 于 
将 数据 存储 到 诸如 硬盘 或 者 内 存 这 样 的 非 易 失 存 储 器 里 面 。 


把 数据 存储 到 非 易 失 存储 器 里 面 同样 也 有 多 种 方法 可 选 ， 而 本 贡 
要 介绍 的 是 把 数据 存储 到 文件 系统 里 面 的 相关 技术 。 说 得 更 具体 一 
点 ， 我 们 将 要 学 习 的 是 如 何 通过 Go 语言 以 两 种 不 同 的 方式 将 数据 存储 
到 文件 里 面 : 第 一 种 方式 需要 用 到 通用 的 CSV (comma-separated 
value， 喜 号 分 隅 值 ) 文本 格式 ， 而 第 二 种 方法 则 需要 用 到 Go 语言 特有 
的 gob 包 。 


CSV 是 一 种 常见 的 文件 格式 ， 用 户 可 以 通过 这 种 格式 癌 系 统 传递 
数据 。 当 你 需要 用 户 提 供 大 量 数据 ， 但 是 却 因为 某 些 原因 而 无 法 让 用 
户 把 数据 填 入 你 提供 的 表单 时 ，CSV 格 式 束 可 以 派 上 用 场 了 : 你 只 需 
要 让 用 户 使 用 电子 表格 程序 (spreadsheet) 输入 所 有 数据 ， 然 后 将 这 
些 数 据 导出 为 CSV 文 件 ， 并 将 其 上 传 到 你 的 Web 应 用 中 ， 这 样 就 可 以 
在 获得 CSV 文 件 之 后 ， 根 据 上 自己 的 需要 对 数据 进行 解码 。 同 样 地 ， 你 
的 Web 应 用 也 可 以 将 用 户 的 数据 打包 成 CSV 文 件 ， 然 后 通过 癌 用 户 发 
送 CSV 文 件 来 为 他 们 提供 数据 。 


gob 是 一 种 能 够 存储 在 文件 里 面 的 二 进 制 格式 ， 这 种 格式 可 以 快速 
且 高 效 地 将 内 存 中 的 数据 序列 化 到 一 个 或 多 个 文件 里 面 。 二 进 制 数据 
文件 的 用 途 非 常 多 ， 比 如 ， 在 进行 数据 备份 以 及 有 序 关 机 BOI Ae, 
程序 区 可 以 使 用 二 进 制 数 据 文 件 来 快速 地 存储 程序 中 的 结构 。 正 如 组 
存 机 制 对 应 用 程序 来 说 非常 有 用 一 样 ， 能 够 将 数据 暂时 存储 在 文件 里 
面 ， 并 在 需要 的 时 候 读 取 这 些 数据 ， 对 于 实现 会 话 、 购 物 车 以 及 构建 
临时 工作 空间 (workspace) 也 是 非常 有 用 的 。 


代码 请 单 6-2 展 示 了 打开 一 个 文件 并 对 其 进行 写 入 的 具体 方法 ， 在 
讨论 CSV 文 件 和 gob 二 进 制 文件 的 过 程 中 ， 类 似 的 代码 将 会 反复 出 现 。 


代码 清单 6-2 对 文件 进行 读 写 


package main 


import ( 
"Fmt"! 
"jo/ioutil" 
tos" 


) 


func main() { 
data := []byte("Hello World! \n") 
err := ioutil.WriteFile("datai", data, 0644) @ 
if err != nil { 
panic(err) 


readi, _ := ioutil.ReadFile("datai") 
fmt .Print(string(read1) ) 


filei, _ := os.Create("data2") © 
defer filei.Close() 


bytes, _ := filei.Write(data) 
fmt.Printf("Wrote %d bytes to file\n", bytes) 


file2, _ := os.Open("data2") 
defer file2.Close() 


read2 := make([]byte, len(data) ) 

bytes, _ = file2.Read(read2) 

fmt.Printf("Read %d bytes from file\n", bytes) 
fmt .Println(string(read2) ) 


@ 通过 WriteFile 函数 和 ReadFile 函数 对 文件 进行 写 入 和 读 取 
@ 通过 File 结构 对 文件 进行 写 入 和 读 取 


为 了 减少 需要 展示 的 代码 ， 代 码 清单 6-2 中 的 程序 使 用 了 空 日 标识 
符 来 省 略 各 个 函数 可 能 会 返回 的 错误 。 


在 这 个 代码 清单 里 面 ， 程 序 使 用 了 两 种 不 同 的 方法 来 对 文件 进行 
写 入 和 读 取 。 第 一 种 方法 非常 简单 直接 ， 它 使 用 的 是 ioutil 包 中 的 
WriteFile 函数 和 ReadFile WA: 在 写 入 文件 时 ， 程 序 会 将 文件 
的 名 字 、 需 要 写 入 的 数据 以 及 一 个 用 于 设置 文件 权限 的 数字 用 作 参 数 
调用 writeFile 函数 ;而 在 读 取 文件 时 ， 程 序 只 需要 将 文件 的 名 字 
用 作 参 数 ， 然 后 调用 ReadFile 函数 即 可 。 此 外 ， 无 论 是 传递 给 
WriteFile 的 数据 ， 还 是 ReadFile 返回 的 数据 ， 都 是 一 个 由 字 节 
组 成 的 切片 。 


比 起 前 一 种 方法 ， 使 用 File 结构 读 写 文件 会 显得 更 为 麻烦 一 

些 ， 但 这 种 做 法 的 灵活 性 更 高 。 在 使 用 这 种 方法 实现 文件 写 入 时 ， 程 
序 需要 先 调 用 os 包 的 Create 函数 ， 并 通过 向 该 琅 数 传 入 文件 名 来 创 
建文 件 。 使 用 defer 关闭 文件 是 一 种 值得 提倡 的 做 法 ， 因 为 它 杜 绝 了 
用 户 在 使 用 文件 之 后 忘记 关闭 文件 的 问题 。defer 语句 可 以 将 给 定 的 
函数 调用 推 入 到 一 个 栈 里 面 ， 保 存在 栈 中 的 调用 会 在 包含 defer 语句 
的 函数 返回 之 后 执行 。 对 我 们 的 例子 来 说 ， 这 意味 着 file1 和 file2 
将 会 在 main 函数 执行 完毕 之 后 关闭 。 在 拥有 了 File 结构 之 后 ， 程 序 
就 可 以 通过 它 的 Write 方法 对 文件 进行 写 入 。 除 了 Write 方法 之 外 ， 

File 结构 还 提供 了 其 他 几 个 用 于 写 入 文件 的 方法 。 


使 用 File 结构 读 取 文 件 的 方法 跟 写 入 文件 的 方法 类 似 ， 程 序 需 
要 使 用 os 包 的 0pen 函数 打开 文件 ， 然 后 使 用 File 结构 提供 的 Read 
方法 或 者 其 他 读 取 方 法 来 读 取 文 件 中 的 数据 。 因 为 File 结构 提供 了 
一 些 方法 ， 它 们 允许 用 户 定 位 并 读 取 文 件 中 的 指定 部 分 ， 所 以 使 用 


File 结构 来 读 取 文件 比 起 单纯 地 调用 ReadFile 函数 拥有 更 大 的 灵 
活性 。 


执行 代码 清单 6-2 所 示 的 程序 会 创建 datal 和 data2 两 个 文件 ， 
它们 都 包含 文本 “Hello World!” ° 


6.2.1 读 取 和 写 入 CSV 文 件 


CSV 格 式 是 一 种 文件 格式 ， 它 可 以 让 文本 编辑 器 非常 方便 地 读 写 
由 文本 和 数字 组 成 的 表格 数据 。CSV 的 应 用 非常 广泛 ， 包 括 微软 的 
Excel 和 苹果 的 Numbers 在 内 的 绝 大 多 数 电子 表格 程序 都 支持 CSV 格 
式 ， 因 此 包括 Go 在 内 的 很 多 编程 语言 都 提供 了 能 够 生成 和 处 理 CSV 文 
件数 据 的 函数 库 。 


对 Go 语言 来 说 ，CSV 文 件 可 以 通过 encoding/csv 包 进 行 操 
作 ， 代 码 清 单 6-3 展 示 了 如 何 通 过 这 个 包 来 读 写 CSV 文 件 。 


代码 清单 6-3 读 写 CSV 文 件 


package main 


import ( 
"encoding/csv" 
"Fmt"! 
Nos" 
"strconv" 


) 


type Post struct { 
Id int 
Content string 
Author string 


func main() { 
csvFile, err := os.Create("posts.csv") @ 


if err != nil { 
panic(err) 
i 


defer csvFile.Close() 


allPosts := []Post{ 
Post{Id: 1, Content: "Hello World!", Author: "Sau Sheong"}, 
Post{Id: 2, Content: "Bonjour Monde!", Author: "Pierre"}, 
Post{Id: 3, Content: "Hola Mundo!", Author: "Pedro"}, 
Post{Id: 4, Content: "Greetings Earthlings!", Author: "Sau 
Sheong"}, 


} 


writer := csv.Newwriter(csvFile) 
for _, post := range allPosts { 
line := []string{strconv.Itoa(post.Id), post.Content, 
post.Author} 
err := writer.Write(line) 
if err != nil { 
panic(err) 


} 


writer.Flush() 


file, err := os.Open("posts.csv") 0 
if err != nil { 
panic(err) 
i 


defer file.Close() 


reader := csv.NewReader(file) 
reader.FieldsPerRecord = -1 
record, err := reader .ReadAll() 
if err != nil { 

panic(err) 
} 


var posts []Post 
for _, item := range record { 
id, _ := strconv.ParseInt(item[0], 0, 0) 
post := Post{Id: int(id), Content: item[1], Author: 
item[2]} 
posts = append(posts, post) 
i 


fmt.Println(posts[0].Id) 
fmt.Println(posts[0].Content) 
fmt.Println(posts[0].Author) 


PO 
@ 创建 一 个 CSV 文件 


@ 打开 一 个 CSV 文件 


首先 让 我 们 来 了 解 一 下 如 何 对 CSV 文 件 执行 写 操作 。 在 一 开始 ， 

程序 会 创建 一 个 名 为 posts .csv 的 文件 以 及 一 个 名 为 csvFile 的 变 
量 ， 而 后 续 代码 的 目标 则 是 将 allPosts 变量 中 的 所 有 帖子 都 写 入 这 
个 文件 。 为 了 完成 这 一 目标 ， 程 序 会 使 用 NewWriter 函数 创建 一 个 
新 的 写 入 器 (writer) ， 并 把 文件 用 作 参 数 ， 将 其 传递 给 写 入 器 。 在 此 
之 后 ， 程 序 会 为 每 个 待 写 入 的 帖子 都 创建 一 个 由 字符 串 组 成 的 切片 。 
最 后 ， 程 序 调用 写 入 句 的 Write 方法 ， 将 一 系列 由 字符 串 组 成 的 切片 
写 入 之 前 创建 的 CSV 文 件 。 


如 果 程 序 进行 到 这 一 步 束 结束 并 退出 ， 那 么 前 面 提 到 的 所 有 数据 
都 会 被 写 入 文件 ， 但 由 于 程序 在 接 下 来 的 代码 中 立即 束 要 对 写 入 的 
posts.csv 文件 进行 读 取 ， 而 刚刚 写 入 的 数据 有 可 能 还 清 留 在 缓冲 
区 中 ， 所 以 程序 必须 调用 写 入 器 的 FLush 方法 来 保证 缓冲 区 中 的 所 有 
数据 都 已 经 被 正确 地 写 入 文件 里 面 了 。 


读 取 CSV 文 件 的 方法 和 写 入 文件 的 方法 类 似 。 首 先 ， 程 序 会 打开 
文件 ， 并 通过 将 文件 传递 给 NewReader 函数 来 创建 出 一 个 读 取 器 
(reader) 。 接 着 ,程序 会 将 读 取 器 的 FieldsPerRecord 字段 的 值 
设置 为 负数 ， 这 样 的话 ， 即 使 读 取 句 在 读 取 时 发 现 记 录 (record) 里 
面 缺 少 了 某 些 字段 ， 读 取 进 程 也 不 会 被 中 断 。 反 之 ， 如 果 


FieldsPerRecord 字段 的 值 为 正 数 ， 那 么 这 个 值 就 是 用 户 要 求 从 每 
条 记录 里 面 读 取出 的 字段 数量 ， 当 读 取 器 从 CSV 文 件 里 面 读 取出 的 字 
段 数 量 少 于 这 个 值 时 ，Go 束 会 抛 出 一 个 错误 。 最 后 ， 如 果 
FieldsPerRecord 字段 的 值 为 0 ， 那 么 读 取 器 就 会 将 读 取 到 的 第 一 
条 记录 的 字段 数量 用 作 FieldsPerRecord 的 值 。 


在 设置 好 FieldsPerRecord 字段 之 后 ， 程 序 会 调用 读 取 器 的 
ReadAll 方法 ， 一 次 性 地 读 取 文件 中 包含 的 所 有 记录 ; 但 如 果 文 件 的 
体积 较 大 ， 用 户 也 可 以 通过 读 取 器 提供 的 其 他 方法 ， 以 每 次 一 条 记录 
的 方式 读 取 文件 。ReadA1ll 方法 将 返回 一 个 由 一 系列 切片 组 成 的 切片 
作为 结果 ， 程 序 会 涡 历 这 个 切片 ， 并 为 每 条 记录 创建 对 应 的 Post 结 
构 。 如 果 我 们 运行 代码 清单 6-3 所 示 的 程序 ， 那 么 程序 将 创建 一 个 名 为 
posts.csv 的 CSV 文 件 ， 该 文件 将 包含 以 下 多 个 由 运 号 分 隔 的 文本 
行 : 


1,Hello World!,Sau Sheong 
2,Bonjour Monde!,Pierre 


3,Hola Mundo!, Pedro 
4,Greetings Earthlings!,Sau Sheong 


除 此 之 外 ， 这 个 程序 还 会 读 取 posts .csv 文件 ， 并 打印 出 该 文 
件 第 一 行 的 内 容 : 


1 
Hello World! 


Sau Sheong 


6.2.2 gob, 


encoding/gob 包 用 于 管理 由 gob 组 成 的 流 (stream) ， 这 是 一 
种 在 编码 器 (encoder) 和 解码 器 (decoder) 之 间 进 行 交 换 的 二 进 制 数 
据 ， 这 种 数据 原本 是 为 序列 化 以 及 数据 传输 而 设计 的 ， 但 它 也 可 以 用 
于 对 数据 进行 持久 化 ， 并 且 为 了 让 用 户 能 够 方便 地 对 文件 进行 读 写 ， 
编码 器 和 解码 器 一 般 都 会 分 别 包 庄 起 程序 的 写 入 器 以 及 读 取 器 。 代 码 
清单 6-4 展 示 了 如 何 使 用 gob 包 去 创建 二 进 制 数据 文件 ， 以 及 如 何 去 读 
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代码 清单 6-4 使 用 gob 包 读 写 二 进 制 数据 


package main 


import ( 
"bytes" 
"encoding/gob" 
"Fmt"! 
"io/ioutil" 


) 


type Post struct { 
Id int 
Content string 
Author string 


func store(data interface{}, filename string) { @ 
buffer := new(bytes.Buffer ) 
encoder := gob.NewEncoder (buffer) 
err := encoder .Encode(data) 
if err != nil { 
panic(err) 


err = ioutil.WriteFile(filename, buffer.Bytes(), 0600) 
if err != nil { 
panic(err) 


func load(data interface{}, filename string) { © 
raw, err := ioutil.ReadFile(filename) 
if err != nil { 
panic(err) 


} 
buffer := bytes.NewBuffer(raw) 
dec := gob.NewDecoder (buffer ) 
err = dec.Decode(data) 
if err != nil { 

panic(err) 


} 


func main() { 

post := Post{Id: 1, Content: "Hello World!", Author: "Sau 
Sheong"} 

store(post, "posti") 

var postRead Post 

load(&postRead, "posti") 

fmt .Println(postRead) 


@ 存储 数据 


@ HARE 


跟前 面 展示 的 程序 一 样 ， 代 码 清单 6-4 所 示 的 程序 也 会 用 到 Post 
结构 ， 并 且 也 包含 了 相应 的 store 方法 和 1oad 方法 ， 但 是 跟 之 前 不 
一 样 的 是 ， 这 次 的 store 方法 会 将 帖子 存储 为 二 进 制 数据 ， 而 load 
方法 则 会 通过 读 取 这 些 二 进 制 数据 来 获取 帖子 。 


首先 来 分 析 一 下 store 函数 ， 这 个 函数 的 第 一 个 参数 是 一 个 空 接 
口 ， 而 第 二 个 参数 则 是 被 存储 的 二 进 制 文件 的 名 字 。 虽 然 空 接口 参数 
能 够 接受 任意 类 型 的 数据 作为 值 ， 但 是 在 这 个 函数 里 面 ， 它 接受 的 将 
是 一 个 Post 结构 。 在 接受 了 相应 的 参数 之 后 ，store 函数 会 创建 一 


bytes. Buffer 2444, XY ibn Laie AA Read 方法 和 
Write 方法 的 可 变 长 度 (variable-sized) 字 节 缓冲 区 ， 换 句 话 说 ， 
bytes .Buffer 既是 读 取 器 也 是 写 入 器 。 


在 此 之 后 ，store 玉 数 会 把 缓冲 区 传递 给 NewEncoder may, DA 
此 来 创建 出 一 个 gob 编 码 絮 ， 接 着 调用 编码 器 的 Encode 方法 将 数据 
(也 就 是 Post 结构 ) 编码 到 绥 冲 区 里 面 ， 最 后 再 将 缓冲 区 中 已 编码 
的 数据 写 入 文件 。 


程序 在 调用 store 芳 数 时 ， 会 将 一 个 Post 结构 和 一 个 文件 名 作 
为 参数 ， 而 这 个 函数 则 会 创建 出 一 个 名 为 post1 的 二 进 制 数据 文件 。 


接 下 来 ， 让 我 们 来 研究 一 下 load 函数 ， 这 个 函数 从 二 进 制 数据 
文件 中 载 入 数据 的 步骤 跟 创建 并 写 入 这 个 文件 的 步骤 正好 相反 : 首 
先 ， 程 序 会 从 文件 里 面 读 取出 未 经 处 理 的 原始 数据 ; 接着 ， 程 序 会 根 
据 这 些 原 始 数据 创建 一 个 缓冲 区 ， 并 大 此 为 原始 数据 提供 相应 的 Read 
方法 和 Write 方法 ; 在 此 之 后 ， 程 序 会 调用 NewDecoder KA, HA 
冲 区 创建 相应 的 解码 器 ， 然 后 使 用 解码 器 去 解码 从 文件 中 读 取 的 原始 
数据 ， 并 最 终 得 到 之 前 写 入 的 Post 结构 。 


在 main 函数 里 面 ， 程 序 定义 了 一 个 名 为 postRead 的 Post 结 
构 ， 并 将 这 个 结构 的 引用 以 及 二 进 制 数据 文件 的 名 字 传 递 给 了 load 
函数 ， 而 1oad 函数 则 会 把 读 取 二 进 制 文件 所 得 的 数据 载 入 给 定 的 
Post 结构 。 


当 我 们 运行 代码 清单 6-4 所 示 的 程序 时 ， 将 创建 出 一 个 包含 二 进 制 
数据 的 post1I 文件 一 一 因为 这 个 文件 包含 的 是 二 进 制 数据 ， 所 以 如 采 
直接 打开 这 个 文件 ， 将 会 看 到 一 些 似 平台 无 意义 的 数据 。 除 创建 
post1 文件 之 外 ， 程 序 还 会 读 取 文件 中 的 数据 并 将 其 载 入 Post 结构 
里 面 ， 然 后 在 控制 终端 打印 出 这 个 结构 : 


{1 Hello World! Sau Sheong} 


FT, APRS EAST ARERR, ANE POR 
的 内 容 将 会 讨论 如 何 将 数据 存储 到 一 种 名 为 数据 库 服 务 占 的 特殊 服务 
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6.3 ”Go 与 SQL 


在 内 存 和 文件 系统 上 存储 和 访问 数据 虽然 非常 有 用 ， 但 如 有 果 你 希 
望 在 一 个 健壮 并 且 可 扩展 的 环境 里 面 存储 数据 ， 束 需要 转 疝 使 用 数据 
FEARS ae (database server) 。 数 据 库 服务 锅 是 一 种 程序 ， 它 可 以 让 其 
他 程序 通过 客户 端 -服务 器 模型 (client-server model) 来 访问 数据 ， 并 
且 这 种 访问 只 能 通过 数据 库 服 务 嚣 实现， 而 其 他 形式 的 访问 则 会 被 拒 
绝 。 在 通 浓 情况 下 ， 数 据 库 服务 需 的 客户 端 既 可 以 是 一 个 函数 库 ， 也 
可 以 是 男 一 个 程序 ， 这 个 客户 端 会 与 数据 库 服 务 器 进行 连接 ， 然 后 通 
过 结构 化 查询 语言 (structured query language, SQL) 对 数据 进行 访 
问 。 数 据 库 服务 如 通常 会 作为 系统 的 一 部 分 ， 出 现在 数据 库 管 理 系统 


(database management system) 中 。 


关系 数据 库 管 理 系 统 (relational database management system, 
RDBMS) 也 许 是 最 常见 也 最 流行 的 数据 库 管 理 系统 了 ， 这 种 系统 使 用 
的 是 基于 数据 的 关系 模型 构建 的 天 系数 据 库 。 在 绝 大 多 数 情况 下 ， 天 
系数 据 库 服务 怖 都 是 通过 SQL 来 访问 关系 数据 库 的 。 


关系 数据 库 和 SQL 是 人 们 在 实现 可 扩展 并 且 易 于 使 用 的 数据 存储 
方法 时 最 为 销 见 的 手段 。 本 书 曾经 在 第 ?2 章 对 关系 数据 库 以 及 SQL 做 过 
简单 的 介绍 ， 而 我 们 接 下 来 要 做 的 是 更 加 深入 地 了 解 这 两 项 技术 。 
6.3.1 ”设置 数据 库 

在 开始 学 习 本 和 介绍 的 知识 之 前 ， 读 者 首先 要 做 的 加 是 对 数据 库 
进行 设置 。 本 书 在 第 2 章 就 曾经 介绍 过 安装 并 设置 Postgres 的 具体 方 
法 ， 因 为 本 节 还 会 继续 用 到 Postgres 数 据 库 ， 所 以 如 果 你 尚未 安装 或 者 
设置 好 这 个 数据 库 ， 那 么 请 根据 第 2 章 介绍 的 方法 进行 设置 。 


在 局 动 并 设置 好 数据 库 之 后 ， 我 们 还 需要 执行 以 下 3 个 步 桑 : 
(1) 创建 数据 库 用 户 ; 

(2) 为 用 户 创 建 数 据 库 ; 

(3) 运行 安装 脚本 ， 创 建 执行 相关 操作 所 需 的 表 。 


首先， 我 们 可 以 通过 在 命令 行 执行 以 下 命令 来 创建 数据 库 用 户 : 


createuser -P -d gwp 


这 一 命令 会 创建 出 一 个 名 为 gwp 的 Postgres 数 据 库 用 户 ， 其 中 -P 
选项 会 让 createuser 程序 在 执行 时 弹出 一 个 提示 符 ， 只 需要 在 提示 
符 出 现 之 后 输入 相应 的 字符 串 ， 就 可 以 将 其 设置 为 gwp 用 户 的 密码 ， 
而 -d 选项 则 会 赋予 gwp 用 户 创建 数据 库 所 需 的 权限 。 


接着 ， 我 们 需要 为 gwp 用 户 创 建 数 据 库 。 通 过 在 命令 行 执行 以 下 
命令 ， 我 们 就 可 以 创建 一 个 名 为 gwp 的 数据 库 : 


createdb gwp 


注意 ， 这 个 数据 库 的 名 字 跟 我 们 刚刚 创建 的 数据 库 用 户 的 名 字 是 
一 样 的 ， 都 是 gwp。 虽然 数据 库 用 户 也 可 以 创建 与 目 己 名 字 不 同 的 数 
据 库 ， 但 这 样 做 需要 额外 的 权限 设置 ， 所 以 为 了 让 事情 尽 可 能 简单 ， 
我 们 这 里 将 使 用 默认 的 数据 库 命 名 方式 ， 也 束 是 ， 为 数据 库 用 户 创建 
一 个 与 之 同名 的 数据 库 。 


在 拥有 了 数据 库 之 后 ， 我 们 还 需要 创建 一 个 表 ， 这 个 表 也 是 接 下 
来 的 内 容 中 我 们 唯一 需要 使 用 的 表 。 首 先 ， 我 们 需要 创建 一 个 名 为 
setup. sql 的 文件 ， 并 将 代码 清单 6-5 所 示 的 内 容 键 入 该 文件 中 。 


代码 清单 6-5 ”用 于 创建 表 的 脚本 


create table posts ( 
id serial primary key, 


content text, 
author varchar(255) 


); 


接着 ， 我 们 还 需要 在 命令 行 执行 以 下 命令 


psql -U gwp -f setup.sql -d gwp 


NIG, BU soe PRE ASIN TER, E 
每 次 执行 后 续 展示 的 代码 之 前 ， 你 可 能 部 需要 重复 执行 一 次 这 条 命 
令 ， 以 便 清理 并 设置 数据 库 。 


在 创建 并 设置 好 数据 库 之 后 ， 现 在 是 时 候 来 连接 这 个 数据 库 了 。 
代码 清单 6-6 展 示 了 一 个 名 为 store .go 的 文件 ， a es 
Postgres 执 行 了 一 系列 操作 ， 而 接 下 来 的 小 节 将 会 逐一 地 分 析 这 些 操作 
的 实现 原理 。 


代码 清单 6-6 ”使 用 Go 对 Postgres 执 行 CRUD 操 作 


package main 


import ( 
"database/sql" 
"Fmt" 
_ "github.com/1ib/pq" 


) 


type Post struct { 
Id int 
Content string 
Author string 


} 
var Db ”sql.DB 
func init() { 

var err error 

Db, err = sql.Open("postgres", "user=gwp dbname=gwp 
password=gwp 

=sslmode=disable") @ 

if err != nil { 

panic(err) 


} 


func Posts(limit int) (posts []Post, err error) { 
rows, err := Db.Query("select id, content, author from posts 
limit $1", 
= limit ) 
if err != nil { 
return 
i 


for rows.Next() { 
post := Post{} 
err = rows.Scan(&post.Id, &post.Content, &post.Author ) 
if err != nil { 
return 


} 
posts = append(posts, post) 


rows.Close() 
return 


} 


func GetPost(id int) (post Post, err error) { @ 
post = Post{} 
err = Db.QueryRow( "select id, content, author from posts where 


id = 
=$1", id).Scan(&post.Id, &post.Content, &post.Author ) 
return 
} 
func (post *Post) Create() (err error) { © 
statement := "insert into posts (content, author) values ($1, 
$2) 
=returning id" 
stmt, err := Db.Prepare(statement ) 
if err != nil { 
return 
i 
defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 
} 


func (post *Post) Update() (err error) { 

_, err = Db.Exec("update posts set content = $2, author = $3 
where id = 

=$1", post.Id, post.Content, post.Author) @ 

return 


} 


func (post *Post) Delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) ® 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
(6) 
fmt.Println(post) 
post.Create() 
fmt.Println(post) @ 


readPost, _ := GetPost(post.Id) 
fmt.Println(readPost) © 


readPost.Content = "Bonjour Monde!" 
readPost.Author = "Pierre" 
readPost .Update() 


posts, _ := Posts() 
fmt.Println(posts) 9 


readPost.Delete() 


O 连接 到 数据 库 


@ 获取 单独 一 篇 帖子 

© 创建 一 坑 新 帖子 

@ 更 新 帖子 

© 删除 一 篇 帖子 

© {0 Hello World! Sau Sheong} 


@ {1 Hello World! Sau Sheong} 


© {1 Hello World! Sau Sheong} 


© [{1 Bonjour Monde! Pierre}] 


6.3.2 ”连接 数据 库 


程序 在 对 数据 库 执 行 任何 操作 之 前 ， 都 需要 先 与 数据 库 进 行 连 
接 ， 代 码 清单 6-7 展 示 了 实现 这 一 动作 的 具体 过 程 : 程序 首先 使 用 Db 
变量 定义 了 一 个 指向 sq1.DB 结构 的 指针 ， 然 后 使 用 init() 函数 来 
初始 化 这 个 变量 (Go 语言 的 每 个 包 都 会 自动 调用 定义 在 包 内 的 
init() 函数 ) 


代码 清单 6-7 ”用 于 创建 数据 库 句柄 的 函数 


var Db *sql.DB 


func init() { 

var err error 

Db, err = sql.Open("postgres", "user=gwp dbname=gwp 
password=gwp 


sslmode=disable" ) 
if err != nil { 


panic(err) 
} 
} 


Sql. DB 结构 是 一 个 数据 库 句 柄 (handle) ， 它 代表 的 是 一 个 包含 
了 零 个 或 任意 多 个 数据 库 连 接 的 连接 池 (pool) ， 这 个 连接 池 由 sq1 
包 管 理 。 程 序 可 以 通过 调用 0pen 函数 ， 并 将 相应 的 数据 库 张 动 名 字 
(driver name) 以 及 数据 源 名 字 (datasource name) 传递 给 该 函数 来 
建立 与 数据 库 的 连接 。 比 如 ， 在 上 面 展示 的 例子 中 ， 程 序 使 用 的 是 


postgres Må) ° BWR FE MAP E PAE OIE, CAR 
URSA DAUM Sj Te EET IER ° Open 函数 在 执行 之 后 会 返回 一 
个 指向 sq1.DB 结构 的 指针 作为 结果 。 


需要 注意 的 是 ，0pen 函数 在 执行 时 并 不 会 真正 地 与 数据 库 进 行 
连接 ， 它 甚至 不 会 检查 用 户 给 定 的 参数 : open 函数 的 真正 作用 是 设 
置 好 连接 数据 库 所 需 的 各 个 结构 ， 并 以 惰性 的 方式 ， 等 到 真正 需要 时 
才 建 立 相 应 的 数据 库 连 接 。 


此 外 ， 因 为 sq1.DB 只 是 一 个 句柄 而 不 是 实际 的 连接 ， 而 这 个 句 
柄 代表 的 是 一 个 会 自动 对 连接 进行 管理 的 连接 池 ， 所 以 尽管 用 户 可 以 
手动 关闭 sq1.DB ， 但 是 在 实际 中 通常 并 不 需要 这 样 做 。 在 上 面 展示 
的 例子 中 ， 程 序 通过 全 局 定义 的 Db 变量 在 各 个 CRUD 方 法 以 及 函数 中 
使 用 sq1.DB 结构 ; 但 除 此 之 外 ， 我 们 也 可 以 选择 在 创建 sq1.DB 结 
构 之 后 ， 通 过 向 方法 或 者 函数 传递 这 个 结构 的 方式 来 使 用 它 。 


到 目前 为 止 ， 我 们 讨论 的 都 是 0pen 画 数 ， 这 个 函数 接受 数据 库 
驱动 名 字 和 数据 源 名 字 作 为 参数 ， 然 后 返回 一 个 sql .DB 结构 作为 结 
果 。 那 么 程序 本 身 又 是 如 何 获取 数据 库 驱 动 的 呢 ? 一 般 来 说 ， 程 序 都 
会 癌 Register 函数 提供 一 个 数据 库 驱 动 名 字 以 及 一 个 实现 了 
driver.Driver 接口 的 结构 ， 以 此 来 注册 将 要 用 到 的 数据 库 驱 动 ， 
就 像 这 样 : 


sql.Register("postgres", &drv{}) 


这 个 例子 中 的 postgres Menta ees, Mdrv 则 是 实 
现 了 Driver 接口 的 结构 。 你 也 许 已 经 注意 到 了 ， 前 面 展示 的 数据 库 
程序 并 没有 包含 类 似 的 注册 代码 ， 这 是 因为 程序 使 用 的 第 三 方 Postgres 
驱动 在 修 导 入 的 时 候 已 经 目 行 实 现 了 注册 : 


import ( 
"Fmt"! 
"database/sql" 


_ "github.com/1ib/pq" 


上 面 这 段 代 码 中 的 github .com/1ib/pq 包 就 是 程序 导入 的 
Postgres 驱 动 ， 在 导入 这 个 包 之 后 ， 包 内 定义 的 ijnit 函数 就 会 被 调 
用 ， 并 对 其 自身 进行 注册 。 因 为 Go 语言 没有 提供 任何 官方 数据 库 驱 
动 ， 所 以 Go 语言 的 所 有 数据 库 驱 动 都 是 第 三 方 函 数 库 ， 并 且 这 些 库 必 
须 遵 守 sql.driver 包 中 定义 的 接口 。 注 意 ， 因 为 程序 在 操作 数据 库 
的 时 候 只 需要 用 到 database/sql ， 而 不 需要 直接 使 用 数据 库 驱 动 ， 
所 以 程序 在 导入 Postgres 数 据 库 驱 动 的 时 候 将 这 个 包 的 名 字 设 置 成 了 下 
划 线 (_) 。 这 种 引用 数据 库 驱 动 的 方式 可 以 让 用 户 在 不 修改 代码 的 
情况 下 升级 驱动 ， 或 者 修改 驱动 实现 。 


至 于 安装 驱动 这 一 操作 ， 则 可 以 通过 在 命令 行 里 执行 以 下 命令 来 
完成 : 


go get "github.com/lib/pq" 


这 一 命令 会 从 代码 库 中 获取 驱动 的 具体 代码 ， 并 将 这 些 代码 放置 
到 包 库 (package repository) 里 面 ， 当 需要 用 到 这 个 驱动 时 ， 编 译 器 
束 会 把 驱动 代码 与 用 户 编写 的 代码 一 同 编译 。 


6.3.3 ”创建 帖子 


在 完成 了 数据 库 的 初步 设置 之 后 ， 现 在 是 时 候 创 建 我 们 的 首 条 数 
据 库 记 录 了 。 本 市 还 会 用 到 之 前 儿 市 展示 过 的 Post 结构 ， 跟 之 前 不 
一 样 的 是 ， 这 次 展示 的 程序 将 不 会 再 把 Post 结构 包含 的 信息 存储 到 
内 存 或 者 文件 中 ， 而 是 把 这 些 信息 存储 到 Postgres 数 据 库 中 ， 并 在 需要 
的 时 候 从 数据 库 中 获取 这 些 信息 。 


前 面 的 示例 程序 向 我 们 展示 了 如 何 使 用 不 同 的 函数 执行 数据 的 创 
建 、 获 取 、 更 新 和 删除 操作 ， 而 在 这 一 闻 ， 我 们 将 会 了 解 到 使 用 
Create 函数 创建 新 帖子 的 更 多 细节 。 在 仔细 研究 Create 函数 的 代 
码 之 前 ， 让 我 们 先 来 了 解 一 下 创建 帖子 的 具体 步骤 。 


创建 帖子 首先 要 做 的 是 创建 一 个 Post 结构 ， 并 为 该 结构 的 
Content 字段 和 Author 字段 设置 值 。 需 要 注意 的 是 ， 因 为 结构 的 Id 
字段 的 值 通常 是 由 数据 库 的 目 增 主键 自动 生成 的 ， 所 以 我 们 并 不 需要 
为 这 个 字段 设置 值 。 


post := Post{Content: "Hello World!", Author: "Sau Sheong"} 


如 果 我 们 现在 使 用 一 个 fmt ,Println 语句 打印 这 个 结构 ， 会 看 
到 Id 字段 的 值 被 初始 化 成 了 0 : 


fmt.Println(post) ©@ 


@ {0 Hello World! Sau Sheong} 


现在 ， 我 们 可 以 通过 执行 Post 结构 的 Create 方法 ， 把 结构 中 包 
含 的 数据 存储 到 数据 库 的 记录 (record) 里 面 : 


post.Create() 


Create 方法 在 发 生 故 障 时 会 返回 一 个 错误 ， 但 为 了 让 代码 保持 
简单 ， 我 们 这 里 暂且 先 省 略 相 应 的 错误 处 理 代 码 。 现 在 ， 再 次 打印 这 
个 Post 结构 : 


fmt.Println(post) @ 


@ {1 Hello World! Sau Sheong} 


从 打印 的 结果 可 以 看 到 ，Id 字段 的 值 现在 被 设置 成 J 了 1。 在 了 解 
了 使 用 Create 函数 创建 新 帖子 的 具体 步 又 之 后 ， 现 在 定时 候 来 看 看 
代码 请 单 6-8， 了 解 一 下 它 的 具体 实现 代码 了 。 


代码 清单 6-8 创建 一 篇 帖子 


func (post *Post) Create() (err error) { 

statement := "insert into posts (content, author) values ($1, 
$2) 

=returning id " 

stmt, err := db.Prepare(statement ) 


if err != nil { 
return 


i 
defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 


if err != nil { 
return 
return 


Create 函数 是 Post 结构 的 一 个 方法 ， 这 一 点 可 以 通过 Create 
函数 的 定义 看 出 : 在 func 关键 字 和 函数 名 Create 之 间 ， 有 一 个 指向 
Post 结构 的 引用 ， 这 个 名 为 post 的 引用 也 被 称 为 方法 的 接收 者 


(receiver) ， 接 收 者 可 以 不 使 用 & 符号 ， 直 接 在 方法 内 部 对 结构 进行 
引用 。 


Create 方法 做 的 第 一 件 事 是 定义 一 条 SQL 预 处 理 语句 ， 一 条 预 
处 理 语 句 (prepared statement) 就 是 一 个 SQL 语句 模板 ， 这 种 语句 通 
常用 于 重复 执行 指定 的 SQL 语句 ， 用 户 在 执行 预 处 理 语 句 时 需要 为 语 
句 中 的 参数 所 供 实际 值 。 


比如 ， 在 创建 数据 库 记 录 的 时 候 ，Create 函数 就 会 使 用 实际 值 
去 替换 以 下 语句 中 的 $1 和 $2 : 


statement := "insert into posts (content, author) values ($1, $2) 


returning id" 


除了 在 数据 库 里 面 创建 记录 之 外 ， 这 个 语句 还 会 要 求 数 据 库 返回 
id 列 的 值 ， 本 文 稍 后 就 会 说 明 这 样 做 的 具体 原因 。 


为 了 创建 预 处 理 语 句 ， 程 序 使 用 了 sql .DB 结构 的 Prepare 方 


法 : 
stmt, err := db.Prepare(statement ) 


这 行 代码 会 创建 一 个 指向 sql.Stmt 接口 的 引用 ， 这 个 引用 就 是 
上 面 提 到 的 预 处 理 语句 。sq1.Stmt 接口 的 定义 位 于 sql.Driver 包 
当中 ， 而 具体 的 结构 则 由 数据 库 驱 动 实 现 。 


之 后 ， 程 序 会 调用 预 处 理 语句 的 QueryRow 方法 ， 并 把 来 目 接收 
者 的 数据 传递 给 该 方法 ， 以 此 来 执行 预 处 理 语句 : 


err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 


我 们 之 所 以 在 这 里 使 用 QueryRow 方法 ， 是 因为 我 们 只 想 要 获取 
一 个 指向 sql. Row 结构 的 引用 : 如 果 QueryRow 发 现 被 执行 的 SQL 语 
名 返回 了 多 于 一 个 sq1.Row ， 那 么 它 只 会 返回 结果 中 的 第 一 个 
sql.Row ， 并 丢弃 剩余 的 所 有 sq1.Row。 因 为 QueryRow 方法 的 返 
回 值 只 有 一 个 sql1.Row 结构 ， 它 不 会 返回 任何 错误 ， 所 以 QueryRow 
方法 通常 会 跟 Row 结构 的 Scan 方法 搭配 使 用 ， 并 由 Scan 方法 把 行 中 
的 值 复制 到 程序 为 其 提供 的 参数 里 面 。 正 如 上 面 的 代码 所 示 ，Scan 
方法 会 把 SQL 查 询 语句 返回 的 id 列 的 值 设 置 为 post 接收 者 的 Id 字段 
的 值 ， 这 也 是 我 们 前 面 在 编写 预 处 理 语句 时 ， 要 求 SQL 查询 语句 返回 
id 列 的 值 的 原因 。 很 明显 ， 因 为 接收 者 的 Content 字段 和 Author 
字段 都 已 经 有 值 了 ， 所 以 程序 最 后 要 做 的 就 是 将 接收 者 的 Id 字段 的 值 


设置 成 数据 库 生 成 的 目 增 整数 。 现 在 ， 正 如 你 所 料 ， 因 为 post 变量 
的 Id 字段 也 已 经 设置 了 值 ， 所 以 程序 得 到 的 将 是 一 个 完整 地 进行 了 设 
置 的 Post 结构 ， 并 且 该 结构 包含 的 数据 与 数据 库 记 了 录 的 数据 完全 一 
Mo 


6.3.4 ”获取 帖子 


在 学 会 如 何 创 建 帖 子 之 后 ， 我 们 很 目 然 地 就 要 学 习 如 何 获 取 帖 子 
了 。 跟 前 面 一 样 ， 在 编写 获取 帖子 的 函数 之 前 ， 我 们 需要 先 了 解 一 下 
获取 帖子 的 具体 步 骆 。 因 为 程序 在 壬 试 获取 帖子 的 时 候 是 没有 现成 的 
Post 结构 可 用 的 ， 所 以 它 目 然 也 无 法 通过 为 Post 结构 定义 方法 来 获 
取 帖 子 了 。 为 此 ， 程 序 需 要 定义 一 个 GetPost 函数 ， 这 个 函数 接受 帖 
子 的 Id 作为 参数 ， 并 返回 一 个 包含 了 完整 帖子 数据 的 Post 结构 作为 结 


readPost, _ := GetPost(1) 
fmt.Println(readPost) @ 


@ {1 Hello World! Sau Sheong} 


这 段 代 码 没 有 像 之 前 展示 过 的 代码 清单 那样 ， 向 GetPost 函数 传 
Æpost.Id 变量 ， 而 是 直接 向 GetPost 函数 传递 了 帖子 的 ID 值 1 ， 
以 此 来 强调 函数 是 通过 帖子 ID 来 获取 帖子 的 。 代 码 清单 6-9 展 示 了 
GetPost 函数 的 具体 实现 代码 。 


代码 清单 6-9 ”获取 一 篇 帖子 


func GetPost(id int) (post Post, err error) { 

post = Post{} 

err = Db.QueryRow( "select id, content, author from posts where 
id = 


=$1", id).Scan(&post.Id, &post.Content, &post.Author ) 
return 


} 


GetPost HAE LAE [SSM Post 结构 ， 然 后 在 对 结构 进 
行 设置 之 后 ， 将 其 用 作 函 数 的 返回 值 : 


跟 之 前 一 样 ， 程 序 通 过 串联 QueryRow 方法 和 Scan 方法 ， 将 执 
行 查询 所 得 的 数据 复制 到 空 的 Post 结构 里 面 。 需 要 注意 的 是 ， 因 为 
获取 单个 帖子 无 需 重 复 执行 相同 的 SQL 语 句 ， 所 以 程序 使 用 的 是 
sql .DB 结构 的 QueryRow 方法 而 不 是 sql.Stmt 结构 的 QueryRow 
方法 。 实 际 上 ，Create 方法 和 GetPost 函数 既 可 以 使 用 sql.DB 来 
实现 ， 也 可 以 使 用 sql.Stmt 来 实现 ， 在 这 里 使 用 sq1 .DB 而 不 是 沿 
用 sql.Stmt 只 是 为 了 展示 另 一 种 可 行 的 做 法 。 


在 将 数据 库 包含 的 数据 填充 到 衬 的 Post 结构 之 后 ，GetPost 就 
会 将 这 个 结构 返回 给 调用 函数 。 
6.3.5 ”更 新 帖子 


在 学 会 如 何 获取 帖子 之 后 ， 我 们 接 下 来 要 做 的 殉 是 学 习 如 何 对 数 
据 库 记录 中 的 信息 进行 更 新 。 假 设 现在 程序 已 经 通过 获取 操作 把 帖子 


es | T readPost 变量 里 面 ， 那 么 它 应 该 可 以 对 帖子 进行 修改 ， 并 
过 更 新 操作 将 这 些 修改 反映 至 数据 库 : 


readPost.Content = "Bonjour Monde!" 


readPost.Author = "Pierre" 
readPost .Update() 


更 新 操作 可 以 通过 为 Post 结构 添加 Update 方法 来 实现 ， 代 码 清 
单 6-10 展 示 了 这 个 方法 的 具体 实现 代码 。 


代码 清单 6-10 更 新 一 篇 帖子 


func (post *Post) Update() (err error) { 
_, err = Db.Exec("update posts set content = $2, author = $3 
where id = 


=$1", post.Id, post.Content, post.Author) 
return 


跟 创 建 帖子 时 的 做 法 不 同 ， 这 次 展示 的 更 新 操作 没有 使 用 预 处 理 
语句 ， 而 征 直 接 调 用 sq1.DB 结构 的 Exec 方法 。 这 是 因为 程序 既 不 需 
要 对 接收 者 进行 任何 更 新 ， 也 不 需要 对 方法 返回 的 结果 进行 扫 摘 

(scan) ， 所 以 它 才 会 选择 使 用 速度 更 快 的 Exec 方法 来 执行 查询 : 


_, err = Db.Exec(post.Id, post.Content, post.Author) 


Exec 方法 会 返回 一 个 sql.Result 和 一 个 可 能 出 现 的 错误 ， 其 
中 sql.Result 记录 的 是 受 查 询 影 响 的 行 的 数量 以 及 可 能 会 出 现 的 最 
后 插入 id。 因 为 更 新 操作 对 sql .Result 记录 的 这 两 项 信息 都 不 感 兴 


趣 ， 所 以 程序 会 通过 将 sql .Result 赋值 给 下 划 线 (_) 来 忽略 它 。 
如 果 一 切 顺 利 ， 没 有 出 现 错误 ， 当 Exec 执行 完毕 时 ， 给 定 的 帖子 就 
会 锌 更 新 。 


6.3.6 ”删除 帖子 


到 目前 为 止 ， 我们 已 经 学 习 了 如 何 创 建 、 获 取 和 更 新 帖子 ， 那 么 
接 下 来 要 考虑 的 就 是 如 何在 不 需要 这 些 帖子 的 时 候 删 除 它 们 了 。 比 如 
说 ， 假 设 程序 已 经 通过 获取 操作 将 一 篇 帖子 存储 到 了 readPost 变量 
里 面 ， 那 么 接 下 来 就 可 以 通过 调用 readPost 变量 的 Delete 方法 来 
删除 帖子 : 


readPost .Delete() 


Delete MWAI Fi tal, (STS 6-11 SIX TTS 
具体 定义 ， 里 面 使 用 的 都 是 前 面 已 经 介绍 过 的 技术 。 


代码 清单 6-11 删除 一 篇 帖子 


func (post *Post) Delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 


return 


跟前 面 更 新 帖子 时 一 样 ，Delete 方法 直接 通过 调用 sql .DB 结 
构 的 Exec 方法 来 执行 SQL 查询 ， 并 且 因 为 Delete 方法 也 对 Exec 方 


法 返回 的 结果 不 感 兴趣 ， 所 以 它 也 会 把 Exec 退回 的 结 采 赋值 给 了 下 
划 线 (_) 


也 许 你 已 经 注意 到 了 ， 与 Post 结构 有 关 的 各 个 方法 以 及 函数 都 
征 以 一 种 非常 随意 的 方式 进行 定义 的 ， 所 以 在 需要 的 时 候 ， 你 也 可 以 
根据 目 己 的 想法 来 修改 这 些 方法 和 函数 。 举 个 例 于 ， 除 了 “和 爷 修 改 已 有 
的 Post 结构 ， 然 后 再 调用 Update 方法 将 更 新 反映 到 数据 库 里 面 * 这 
种 更 新 方法 之 外 ， 你 还 可 以 考虑 直接 将 需要 修改 的 内 容 当 作 参 数 传递 
给 Update FIK; 义 或 者 说 ， 你 也 可 以 考虑 创建 更 多 不 同 的 获取 画 
数 ， 然 后 通过 特定 的 列 或 者 特定 的 过 滤 右 来 获取 你 想 要 的 帖子 。 


6.3.7 一 次 获取 多 篇 帖子 


根据 给 定 的 最 大 帖子 数量 ， 一 次 从 数据 库 里 面 获取 多 篇 帖子 ， 是 
一 种 非常 常见 的 做 法 。 换 句 话 说 ， 程 序 可 以 通过 执行 以 下 命令 ， 从 数 
据 库 里 面 获取 前 十 篇 帖子 ， 并 将 它们 放 入 到 一 个 切片 里 面 : 


posts, _ := Posts(10) 


代码 清单 6-12 展 示 了 完成 这 一 操作 的 Posts 芳 数 的 具体 定义 。 


代码 清单 6-12 一 次 获取 多 篇 帖子 


func Posts(limit int) (posts []Post, err error) { 
rows, err := Db.Query("select id, content, author from posts 
limit $1", 
=limit ) 
if err != nil { 
return 


} 


for rows.Next() { 
post := Post{} 
err = rows.Scan(&post.Id, &post.Content, &post.Author ) 
if err != nil { 
return 


posts = append(posts, post) 


rows.Close() 
return 


Posts 函数 使 用 了 sql .DB 结构 的 Query 方法 来 执行 查询 ， 这 个 
方法 会 返回 一 个 Rows 接口 。Rows 接口 是 一 个 迭代 癸 ， 程 序 可 以 通过 
重复 调用 它 的 Next 方法 来 对 其 进行 大 代 并 获得 相应 的 sql .Row ; 当 
所 有 行 都 被 迭代 完毕 时 ，Next 方法 将 返回 io .EOF 作为 结 


Posts 函数 在 每 次 进行 迭代 的 时 候 都 会 创建 一 个 Post 结构 ， 并 
将 行 包 含 的 数据 扫描 到 结构 里 面 ， 然 后 再 将 这 个 结构 追加 到 posts Y 
片 的 末尾。 当 所 有 行 都 被 迭代 完毕 之 后 ，Posts 函数 就 会 将 这 个 包含 
了 多 个 Post 结构 的 posts 切片 返回 给 调用 者 。 


6.4 Go 与 SQL 的 关系 


关系 数据 库 之 所 以 能 够 成 为 一 种 流行 的 数据 存储 手段 ， 其 中 一 个 
原因 驶 是 它 可 以 在 表 与 表 之 间 建 立 关 系 ， 从 而 使 不 同 的 数据 能 够 以 一 
种 一 致 且 易于 理解 的 方式 互相 进行 关联 。 基 本 上 ， 有 4 种 方法 可 以 把 一 
项 记录 与 其 他 记录 关联 起 来 : 


一 对 一 关联 ， 也 被 称 为 “有 一 个 ”(has one) 关系 ， 比 如 一 个 用 户 
必然 会 拥有 一 个 个 人 简介 ; 

一 对 多 关联 ， 也 被 称 为 < 有 多 个 ” (has many) 关系 ， 比 如 一 个 用 
户 可 能 会 拥有 多 篇 论坛 帖子 ; 

多 对 一 关联 ， 也 被 称 为 “属于 ” (belongs to) 关系 ， 比 如 多 篇 论坛 
帖子 可 能 会 同属 于 某 一 个 用 户 ; 

多 对 多 关联 ， 比如 一 个 用 户 可 能 会 参与 论坛 里 面 多 篇 帖子 的 讨 
论 ， 而 一 篇 帖子 里 面 也 会 有 多 个 用 户 在 发 表 评 论 。 


在 前 面 的 内 容 中 ， 我 们 已 经 学 习 了 如 何 对 单个 数据 库 表 执 行 标准 
的 CRUD 操 作 ， 但 我 们 还 不 知道 如 何 才能 对 两 个 相关 联 的 表 执 行 相同 
的 操作 。 因 此 ， 在 这 一 节 ， 我 们 将 要 学 习 如 何 通 过 一 对 多 关系 为 一 篇 
论坛 帖子 构建 多 篇 评论 。 与 此 同时 ， 因 为 一 对 多 关系 跟 多 对 一 关系 实 
际 上 就 古 一 体 两 面 的 两 个 东西 ， 所 以 除了 一 对 多 关系 之 外 ， 我 们 还 会 
学 习 如 何 使 用 多 对 一 关系 。 


6.4.1 ”设置 数据 库 


在 正式 开始 之 前 ， 我 们 需要 再 次 对 数据 库 进 行 设置 ， 不 过 跟 上 次 
只 创建 一 个 表 的 做 法 不 同 ， 这 一 次 我 们 将 会 创建 两 个 表 。 此 外 ， 这 次 
设置 需要 用 到 的 命令 跟 上 一 次 设置 使 用 的 命令 完全 一 样 ， 只 是 被 执行 
Msetup.sql 脚本 跟 之 前 的 有 所 不 同 ， 代 码 清 单 6-13 展 示 了 新 脚本 的 
具体 定义 。 


代码 清单 6-13 ”创建 两 个 相关 联 的 表 


drop table posts cascade if exists; 
drop table comments if exists; 


create table posts ( 

id serial primary key, 
content text, 

author varchar(255) 


) ; 


create table comments ( 
id serial primary key, 
content text, 
author varchar(255), 
post_id integer references posts(id) 


这 次 的 脚本 除了 会 创建 posts 表 之 外 ， 还 会 创建 comment s K, 
comments 表 的 大 部 分 列 都 跟 posts 表 一 样 ， 主 要 区 别 在 于 
comments 表 多 了 一 个 额外 的 post_id 列 : 这 个 post_id 会 作为 外 
键 (foreign key) ， 对 posts 表 的 主键 id 进行 引用 。 此 外 ， 因 为 
posts 表 和 comments 表现 在 已 经 通过 主键 和 外 键 建立 起 了 关联 ， 所 
以 用 户 在 删除 posts 表 的 同时 也 需要 将 comments 表 一 并 删除 ， 否 
则 ， 由 于 comments 表 对 posts 表 的 依赖 关系 ， 删 除 posts 表 这 一 
操作 将 无 法 正常 执行 。 


设置 好 相应 的 数据 库 表 之 后 ， 现 在 让 我 们 来 看 看 如 何 使 用 Go 语言 
实现 一 对 多 以 及 多 对 一 关系 。 代 码 清 单 6-14 展 示 了 具体 的 实现 代码 ， 
这 些 代码 都 存储 在 一 个 名 为 store .go 的 文件 里 面 。 


代码 清单 6-14 ”使 用 Go 语言 实现 一 对 多 以 及 多 对 一 关系 


package main 


import ( 
"database/sql" 
"errors" 


"Fmt"! 
_ "github.com/1lib/pq" 
) 


type Post struct { 
Id int 
Content string 
Author string 
Comments [ ]Comment 


} 

type Comment struct { 
Id int 
Content string 
Author string 
Post *Post 

} 


var Db *sql.DB 


func init() { 

var err error 

Db, err = sql.Open("postgres", "user=gwp dbname=gwp 
password=gwp 

=SsSlmode=disable" ) 


if err != nil { 
panic(err) 
} 
} 
func (comment *Comment) Create() (err error) { @ 
if comment.Post == nil { 
err = errors.New("Post not found") 
return 
} 


err = Db.QueryRow("insert into comments (content, author, 
post_id) 

=values ($1, $2, $3) returning id", comment.Content, 
comment.Author, 

=comment.Post.Id).Scan(&comment . Id) 

return 


} 


func GetPost(id int) (post Post, err error) { 
post = Post{} 
post.Comments = []Comment{} 
err = Db.QueryRow( "select id, content, author from posts where 
id = 


=$1", id).Scan(&post.Id, &post.Content, &post.Author ) 


rows, err := Db.Query("select id, content, author from 
comments") 
if err != nil { 
return 
} 
for rows.Next() { 
comment := Comment{Post: &post} 


err = rows.Scan(&comment.Id, &comment.Content, 
&comment .Author ) 
if err != nil { 
return 


} 


post.Comments = append(post.Comments, comment) 


rows.Close( ) 
return 


} 


func (post *Post) Create() (err error) { 
err = Db.QueryRow("insert into posts (content, author) values 
($1, $2) 
=™returning id", post.Content, post.Author).Scan(&post.Id) 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
post.Create() 


comment := Comment{Content: "Good post!", Author: "Joe", Post: 
&post} 

comment .Create() 

readPost, _ := GetPost(post.Id) @ 


fmt .Println(readPost) 
fmt.Println(readPost.Comments) © 
fmt.Println(readPost.Comments[0].Post) © 
} 


@ 创建 一 条 评论 


© {1 Hello World! Sau Sheong [{1 Good post! Joe 0xc20802a1c0}]} 


© [{1 Goodpost! JoeOxc20802a1c0} 


@ &{1 Hello World! Sau Sheong [{1 Good post! Joe 
0xc20802a1c0}]} 


6.4.2 一 对 多 关系 


我 们 首先 需要 考虑 的 是 如 何 使 用 Post 和 Comment 这 两 个 结构 来 
构建 一 对 多 关系 : 


type Post struct { 
Id int 
Content string 
Author string 
Comments [ ]Comment 


type Comment struct { 
Id int 
Content string 
Author string 
Post *Post 


TER, Post 结构 新 增 了 一 个 comments 字段 ， 这 个 字段 是 一 个 
由 任意 多 个 Comment 结构 组 成 的 切片 ， 与 此 同时 ，Comment 结构 也 
新 增 了 一 个 Post 字段 ， 这 个 字段 是 一 个 指向 Post 结构 的 指针 。 初 看 
上 去 ， 程 序 似 乎 会 把 多 个 comment 结构 存储 到 一 个 Post 结构 里 面 ， 
然后 让 Comment 结构 通过 指针 引用 Post 结构 。 但 是 实际 上 ， 因 为 切 
片 也 是 一 个 指向 数组 的 指针 ， 所 以 Post 结构 和 Comment 结构 在 构建 
关系 时 使 用 的 都 是 指针 : 这 种 做 法 可 以 确保 程序 获取 到 的 都 是 同一 个 
Post 结构 或 者 Comment 结构 ， 而 不 是 这 些 结构 的 副本 。 


在 设 定好 Post 结构 和 Comment 结构 之 间 的 关系 之 后 ， 我 们 接 下 
来 要 考虑 的 就 是 如 何 实际 地 构建 这 些 关 系 。 正 如 前 面 所 说 ， 一 对 多 关 
系 实际 上 就 是 多 对 一 关系， 所 以 这 两 个 结构 在 定义 一 对 多 天 系 的 同 
时 ， 也 定义 了 多 对 一 关系 。 当 程序 创建 一 条 新 评论 的 时 候 ， 它 就 会 在 
评论 和 被 评论 的 帖子 之 间 建 立 起 以 上 提 到 的 这 两 种 关系 : 


:= Comment{Content: "Good post!", Author: "Joe", Post: 


comment .Create() 


跟 之 前 的 做 法 一 样 ， 程 序 首先 会 创建 一 个 Comment 结构 ， 然 后 通 
过 调用 该 结构 的 Create 方法 来 创建 评论 ， 并 厌 此 建立 起 评论 与 帖子 
之 间 的 关系 。 代 码 清单 6-15 展 示 了 Comment 结构 的 Create 方法 的 具 
体 定义 。 


代码 清单 6-15 ”创建 评论 ， 并 建立 评论 与 帖子 之 间 的 关系 


func (comment *Comment) Create() (err error) { 
if comment.Post == nil { 
err = errors.New("Post not found") 
return 


err = Db.QueryRow("insert into comments (content, author, 


post_id) 

=values ($1, $2, $3) returning id", comment.Content, 
comment.Author, 

=comment.Post.Id).Scan(&comment . Id) 

return 


在 为 评论 和 帖子 建立 关系 之 前 ，Create 方法 会 先 检查 给 定 的 帖 
子 是 否 存 在 ， 并 在 帖子 不 存在 时 返回 一 个 错误 。 除 了 “通过 post_id 
建立 关系 ”这 一 细节 没有 提 及 之 外 ，Create 方法 的 其 余 代 码 的 行为 跟 
我 们 之 前 描述 的 一 模 一 样 。 


在 建立 起 评论 和 帖子 之 间 的 关系 之 后 ， 我 们 接 下 来 要 考虑 的 就 是 
如 何 修改 GetPost 函数 ， 让 它 可 以 在 获取 帖子 的 同时 ， 一 并 获取 和 与 帖 
子 相 关联 的 评论 。 比 如 说 ， 程 序 在 执行 完 以 下 代码 之 后 ， 应 该 可 以 通 
过 访问 readPost 变量 的 Comments 字段 来 查看 帖子 已 有 的 评论 : 


readPost, _ := GetPost(post.Id) 


代码 清单 6-16 展 示 了 修改 之 后 的 GetPost 函数 的 定义 。 


代码 清单 6-16 ”获取 帖子 及 其 评论 


func GetPost(id int) (post Post, err error) { 
post = Post{} 
post.Comments = []Comment {} 
err = Db.QueryRow( "select id, content, author from posts where 
id = 


=$1", id).Scan(&post.Id, &post.Content, &post.Author ) 


rows, err := Db.Query("select id, content, author from comments 
where 
=post_id = $1", id) 
if err != nil { 
return 


for rows.Next() { 
comment := Comment{Post: &post} 
err = rows.Scan(&comment.Id, &comment.Content, 
&comment .Author ) 
if err != nil { 


return 


post.Comments = append(post.Comments, comment) 


rows.Close() 
return 


} 


GetPost 函数 首先 会 初始 化 Post 结构 中 的 Comments 字段 ， 并 
从 数据 库 里 面 获取 帖子 的 具体 数据 。 在 此 之 后 ， 程 序 会 从 数据 库 里 面 
获取 与 当前 帖子 关联 的 所 有 评论 ， 接 着 迭代 这 些 评论 ， 为 每 个 评论 都 
创建 一 个 comment 结构 并 将 其 追加 到 Comments 切片 里 面 。 当 所 有 评 
论 部 被 迭代 完毕 之 后 ，GetPost 函数 就 会 将 包含 了 评论 的 Post 结构 
返回 给 调用 者 。 正 如 上 壕 内 容 所 示 ， 在 多 个 表 之 间 建 立 关系 并 不 困 
难 ， 但 是 这 一 行为 在 Web 应 用 变 得 越 来 越 庞大 的 同时 就 会 变 得 越 来 越 
磋 烦 。 为 了 解决 这 个 问题 ， 我 们 将 在 接 下 来 的 一 节 中 学 习 如 何 通过 关 
系 映射 器 来 简化 关系 的 构建 方法 。 


里 然 本 节 展 示 了 所 有 数据 库 应 用 都 会 用 到 的 CRUD 操 作 ， 但 这 些 
操作 充其量 只 是 使 用 Go 访问 SQL 数 据 库 的 基本 知识 ， 如 有 果 你 有 兴趣 了 
解 更 多 相关 的 知识 ， 那 么 可 以 去 读 一 下 Go 的 官方 文档 。 


65 ”Go 与 关系 映射 器 


初 看 上 去 ， 将 数据 存储 到 关系 数据 库 里 面 似乎 并 不 是 一 件 轻松 的 
事情 ， 有 非常 多 的 工作 要 做 。 对 不 少 语言 来 说 ， 这 一 判断 是 正确 的 ， 
然而 在 实际 中 ，SQL 与 应 用 之 间 通 常 存在 着 一 些 第 三 方 库 ， 这 些 库 在 
面 回 对 象 编程 语言 中 一 般 称 为 对 象 -关系 映射 器 (object-relational 


mapper, ORM) 。 诸 如 Java 的 Hibernate 以 及 Ruby 的 ActiveRecord 之 类 
的 ORM 都 会 把 关系 数据 库 中 的 表 映 射 为 编程 语言 中 的 对 象 ， 但 为 表 创 
建 映 射 并 不 是 面 问 对 象 编程 语言 的 特权 ， 很 多 其 他 编程 语言 也 拥有 类 
似 的 映射 妖 ， 比 如 ，Scala 有 Activate 框 架 ，Haskell 有 Groundhog 库 ° 


Go 同样 也 拥有 类 似 的 关系 映射 器 (relational mapper) , KP F 
来 将 介绍 其 中 一 些 映 射 器 (因为 ORM 这 一 术语 对 于 Go 来 说 并 不 是 特别 
VERA, PARI TREH R BER ar” II DE ORM RARE PORTE RI] 
的 Go 映射 器 ) 。 


6.5.1 Sqlx 


Sqlx 是 一 个 第 三 方 库 ， 它 为 database/sdl 包 提供 了 一 系列 非常 
有 用 的 扩展 功能 。 因 为 Sqlx 和 database/sql 包 使 用 的 是 相同 的 接 
口 ， 所 以 Sqlx 能 够 很 好 地 兼容 使 用 database/sql 包 的 程序 ， 除 此 之 
外 ，Sqlx 还 提供 了 以 下 这 些 额 外 的 功能 : 


。 通 过 结构 标签 (structtag) 将 数据 库 记 录 (即行 ) 封装 为 结构 、 
映射 或 者 切片 ， 
。 为 预 处 理 语句 提供 具名 参数 支持 。 


代码 清单 6-17 展 示 了 如 何 使 用 Sqlx 及 其 提供 的 StructScan 方法 
来 对 论坛 程序 进行 简化 。 另 外 别 筷 了， 在 使 用 Sqlx 库 之 前 ， 需 要 先 通 
过 执行 以 下 命令 来 获取 这 个 库 : 


go get "github.com/jmoiron/sqlx" 


Ji 


代码 清单 6-17 使 用 Sqlx 重新 实现 论坛 程 


package main 


import ( 
"Fmt"! 
"github.com/jmoiron/sqlx" 


_ "github.com/1lib/pq" 
) 


type Post struct { 
Id int 
Content string 
AuthorName string “db: author” 


} 


var Db *sqlx.DB 


func init() { 

var err error 

Db, err = sqlx.Open("postgres", "user=gwp dbname=gwp 
password=gwp 


=sslmode=disable" ) 
if err != nil { 


panic(err) 
} 


} 


func GetPost(id int) (post Post, err error) { 

post = Post{} 

err = Db.QueryRowx("select id, content, author from posts where 
id = 


=$1", id).StructScan(&post) 


if err != nil { 
return 


return 


} 


func (post *Post) Create() (err error) { 
err = Db.QueryRow("insert into posts (content, author) values 


($1, $2) 
=returning id", post.Content, post.AuthorName).Scan(&post.Id) 
return 

} 


func main() { 
post := Post{Content: "Hello World!", AuthorName: "Sau Sheong"} 
post.Create() 
fmt.Println(post) @ 

} 


@ {1 Hello World! Sau Sheong}} 


代码 清单 中 的 加 粗 代码 展示 了 使 用 Sqlx 与 使 用 database/sql 之 
间 的 区 别 ， 而 其 余 的 则 是 一 些 我 们 之 前 已 经 看 到 过 的 代码 。 首 先 ， 程 
序 现在 不 再 导入 database/sql 包 ， 而 是 导 
github.com/jmoiron/sqlx 包 。 在 默认 情况 下 ，StructScan 会 
根据 结构 字段 名 的 英文 小 写 体 ， 将 结构 中 的 字段 映射 至 表 中 的 列 。 为 
了 演示 如 何 将 指定 的 表 列 映射 至 指定 的 结构 字段 ， 代 码 清 单 6-17 将 原 
来 的 Author 字段 修改 成 了 AuthorName 字段 ， 然 后 通过 结构 标签 来 
指示 Sqlx 应 该 从 author 列 里 面 获取 AuthorName 字段 的 数据 。 本 书 
将 在 第 7 章 对 结构 标签 做 进一步 的 说 明 。 


程序 现在 也 会 使 用 sqLx,DB 结构 来 代替 之 前 的 sql .DB 结构 ， 这 
两 种 结构 非常 相似 ， 只 不 过 sqlx .DB 包含 了 诸如 Queryx 以 及 
QueryRowx 等 额外 的 方法 。 


修改 之 后 的 GetPost arth (i AQueryRowx 代替 了 之 前 的 
QueryRow ° QueryRowx 在 执行 之 后 将 返回 Rowx 结构 ， 这 种 结构 拥 
有 StructScan 方法 ， 该 方法 可 以 将 列 目 动 地 映射 到 相应 的 字段 里 
面 。 另 一 方面 ， 对 于 Create 方法 ， 我 们 还 是 跟 之 前 一 样 ， 使 用 
QueryRow 方法 进行 查询 。 


除了 这 里 提 到 的 特性 之 外 ，Sqlx 还 拥有 其 他 一 些 有 趣 的 特性 ， 感 
兴趣 的 读者 可 以 通过 访问 Sqlx 的 GitHub 页 面 来 了 解 : 
https://github.com/jmoiron/sqlx ° 


Sqlx 是 一 个 有 趣 并 且 有 用 的 database/sql 扩展 ， 但 它 支 持 的 特 
性 并 不 多 。 与 此 相反 ， 我 们 接 下 来 要 学 习 的 Gorm 库 不 仅 把 
database/sql 包 隐 藏 了 起 来 ， 它 还 提供 了 一 个 完整 且 强 大 的 ORM 
机 制 来 代替 database/sqlL 包 。 


6.5.2 Gorm 


Gorm 的 开发 者 声称 Gorm 是 最 棒 的 Go 语言 ORM， 他 们 的 确 所 言 非 
虚 。Gorm 有 是 “Go-ORM" 一 词 的 缩写 ， 这 个 项 目 是 一 个 使 用 Go 实现 的 
ORM， 它 遵循 的 是 与 Ruby 的 ActiveRecord 以 及 Java 的 Hibernate 一 样 的 
道路 。 更 确切 地 说 ，Gorm 遵 循 的 是 数据 映射 器 模式 (Data-Mapper 
pattern) ， 该 模式 通过 提供 映射 器 来 将 数据 库 中 的 数据 映射 为 结构 。 
(在 6.3 节 介绍 关系 数据 库 时 ， 使 用 的 就 是 ActiveRecord 模 式 。) 


Gorm 的 能 力 非 常 强大 ， 它 允许 程序 员 定 义 关 系 、 实 施 数据 迁移 、 
串联 多 个 查询 以 及 执行 其 他 很 多 高 级 的 操作 。 除 此 之 外 ，Gorm 还 能 够 
设置 回调 函 数 ， 这 些 函 数 可 以 在 特定 的 数据 事件 发 生 时 执行 。 因 为 详 


尽 地 摘 述 Gorm 的 各 个 特性 可 能 会 伦 摊 整整 一 章 的 篇 幅 ， 所 以 我 们 在 这 
里 只 会 讨论 它 的 基本 特性 。 代 码 清 单 6-18 展 示 了 使 用 Gorm 重 新 实现 论 
坛 程序 的 方法 ， 跟 之 前 一 样 ， 这 次 的 代码 也 是 存储 在 store. go 文件 
里 面 。 


代码 清单 6-18 使 用 Gorm 实 现 论坛 程序 


package main 


import ( 
"Fmt " 
"github.com/jinzhu/gorm" 
_ "github.com/1ib/pq" 
UL time" 


) 


type Post struct { 
Id int 
Content string 
Author string ‘sql:"not null"” 
Comments []Comment 
CreatedAt time.Time 


} 


type Comment struct { 
Id int 
Content string 
Author string ‘sql:"not null"” 
PostId int sql:"index". 
CreatedAt time.Time 


} 


var Db gorm.DB 


func init() { 
var err error 
Db, err = gorm.Open("postgres", "user=gwp dbname=gwp 
password=gwp 
=SsSlmode=disable" ) 
if err != nil { 
panic(err) 


Db.AutoMigrate(&Post{}, &Comment{}) 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} @ 
fmt.Println(post ) 


Db.Create(&post) @ 
fmt.Println(post) © 


comment := Comment{Content: "Good post!", Author: "Joe"} © 
Db.Model(&post) .ASsociation("Comments") .Append( comment ) 


var readPost Post 
Db.Where("author = $1", "Sau Sheong").First(&readPost) © 
var comments [ ]Comment 
Db.Model(&readPost) .Related(&comments) 
fmt .Println(comments [0] ) © 


@ {0 Hello World! Sau Sheong [] 0001-01-01 00:00:00 +0000 UTC} 


@ 创建 一 篇 帖子 


© {1 Hello World! Sau Sheong [] 2015-04-12 11:38:50.91815604 
+0800 SGT} 


@ 添加 一 条 评论 
O 通过 帖子 获取 评论 
© {1 Good post! Joe 1 2015-04-13 11:38:50.920377 +0800 SGT} 


这 个 者 程序 创建 数据 库 句 柄 的 方法 跟 我 们 之 前 创建 数据 库 句 柄 的 
方法 基本 相同 。 另 外 需要 注意 的 一 点 是 ， 因 为 Gorm 可 以 通过 目 动 数据 
迁移 特性 来 创建 所 需 的 数据 库 表 ， 并 在 用 户 修改 相应 的 结构 时 目 动 对 
数据 库 表 进行 更 新 ， 所 以 这 个 程序 无 需 使 用 setup.sql 文件 来 设置 


数据 库 表 :， 当 我 们 运行 这 个 程序 时 ， 程 序 所 需 的 数据 库 表 就 会 目 动 生 
成 。 为 了 正确 地 运行 这 个 程序 ， 并 让 程序 能 够 正常 地 创建 数据 库 表 ， 
我 们 在 执行 这 个 程序 之 前 必须 先 将 之 前 创建 的 数据 库 表 全 部 删除 : 


func init() { 

var err error 

Db, err = gorm.Open("postgres", "“user=gwp dbname=gwp 
password=gwp sslmode=disable" ) 


if err != nil { 
panic(err) 


} 
Db.AutoMigrate(&Post{}, &Comment{}) 
} 


负责 执行 数据 迁移 操作 的 AutoMigrate 方法 是 一 个 变 长 参数 方 
法 ， 这 种 类 型 的 方法 和 夯 数 能 够 接受 一 个 或 多 个 参数 作为 输入 。 在 上 
面 展 示 的 代码 中 ，AutoMigrate 方法 接受 的 是 Post 结构 和 
Comment 结构 。 得 益 于 目 动 数据 迁移 特性 的 存在 ， 当 用 户 癌 结构 里 面 
添加 新 字段 的 时 候 ，Gorm 就 会 自动 在 数据 库 表 里 面 添加 相应 的 新 列 。 


上 面 的 Gorm 程 序 使 用 了 下 面 所 示 的 Comment 结构 : 


type Comment struct { 
Id int 
Content string 


Author string ‘sql:"not null". 
PostId int 
CreatedAt time.Time 


Comment 结构 里 面 出 现 了 一 个 类 型 为 time .Time 的 CreatedAt 
字段 ， 包 含 这 样 一 个 字段 意味 着 Gorm 每 次 在 数据 库 里 创建 一 条 新 记录 


的 时 候 ， 都 会 目 动 对 这 个 字段 进行 设置 。 


UES, Comment 结构 的 其 中 一 些 字 段 还 用 到 了 结构 标签 ， 以 此 来 
指示 Gorm 应 该 如 何 创建 和 映射 相应 的 字段 。 比 如 ，Comment 结构 的 
Author 字段 就 使 用 了 结构 标签 'sql: "not null"' ， 以 此 来 告 
知 Gorm， 该 字段 对 应 列 的 值 不 能 为 null 。 


跟前 面 展 示 过 的 程序 的 男 一 个 不 同 之 处 在 于 ， 这 个 程序 没有 在 
Comment 结构 里 设置 Post 字段 ， 而 是 设置 了 一 个 PostId 字段 。 
Gorm 会 自动 把 这 种 格式 的 字段 看 作 是 外 键 ， 并 创建 所 需 的 关系 。 


在 了 解 了 Post 结构 和 Comment 结构 的 新 定义 之 后 ， 现 在 ， 让 我 
们 来 看 看 程序 是 如 何 创 建 并 获取 帖子 及 其 评论 的 。 首 先 ， 程 序 会 使 用 
以 下 语句 来 创建 新 的 帖子 : 


post := Post{Content: "Hello World!", Author: "Sau Sheong"} 


Db.Create(&post ) 


这 上段 代码 没有 什么 难民 的 地 方 ， 它 跟 之 前 展示 过 的 代码 的 最 主要 
区 别 在 于 一 一 程序 这 次 遵循 了 数据 映射 器 模 式 ， 它 在 创建 帖子 时 会 使 
用 数据 库 句 柄 gorm, DB 作为 构造 右 ， 而 不 是 像 之 前 遵循 ActiveRecord 
模式 时 那样 ， 通 过 直接 调用 Post 结构 自 有 的 Create 方法 来 创建 帖 
子 。 


如 果 和 直接 查看 数据 库 内 部 ， 应 该 会 看 到 created_at 这 个 时 间 鹤 
列 在 帖子 创建 出 来 的 同时 已 经 自动 被 设置 好 了 。 


在 创建 出 帖子 之 后 ， 程 序 使 用 了 以 下 语句 来 为 帖子 添加 评论 : 


comment := Comment{Content: "Good post!", Author: "Joe"} 


Db.Model(&post).Association("Comments").Append(comment) 


这 段 代码 会 先 创建 出 一 条 评论 ， 然 后 通过 串联 Mode1 方法 、 
Association 方法 和 Append 方法 来 将 评论 添加 到 帖子 里 面 。 注 
意 ， 在 创建 评论 的 过 程 中 ， 我 们 无 需 手动 对 Comment 结构 的 PostId 
字段 执行 任何 操作 。 


最 后 ， 程 序 使 用 了 以 下 代码 来 获取 帖子 及 其 评论 : 


var readPost Post 
Db.Where("author = $1", "Sau Sheong").First(&readPost) 


var comments [ ]Comment 
Db.Model(&readPost ).Related(&comments) 


这 段 代 码 跟 之 前 展示 过 的 代码 有 些 类 似 ， 它 使 用 了 gorm.DB 的 
Where 方法 来 查找 第 一 条 作者 名 为 "Sau Sheong" 的 记录 ， 并 将 这 
条 记录 存储 在 了 readPost 变量 里 面 ， 而 这 条 记录 就 是 我 们 刚刚 创建 
的 帖子 。 之 后 ， 程 序 首 先 调 用 Model 方法 获取 帖子 的 模型 ， 接 着 调用 
Related 方法 获取 帖子 的 评论 ， 并 在 最 后 将 这 些 评论 存储 到 


comments 变量 里 面 。 


正如 之 前 所 说 ， 本 市 展示 的 特性 只 是 Gorm 这 个 ORM 库 众多 特性 
的 一 小 部 分 ， 如 采 你 对 这 个 库 感 兴趣 ， 可 以 通过 
https:Wgithub.coryjinzhu/gorm 了 解 更 多 相关 信息 。 


Gorm 并 不 是 Go 语言 唯一 的 ORM 库 。 除 Gorm 之 外 ，Go 还 拥有 不 少 
同样 具备 众多 特性 的 ORM 库 ， 比 如 ，Beego 的 ORM 库 以 及 GORP 
(GORP 并 不 完全 是 一 个 ORM， 但 它 与 ORM 相 去 不 远 ) © 


在 本 章 中 ， 我 们 了 解 了 构建 Web 应 用 所 需 的 基本 组 件 ， 而 在 接 下 
来 的 一 章 中 ， 我 们 将 要 开始 讨论 如 何 构建 Web 服 务 。 


6.6 ”小结 


。 通过 使 用 结构 将 数据 存储 在 内 存 里 面 ， 以 此 来 构建 数据 缓存 机 制 
并 提高 响应 速度 

。 通过 使 用 CSV 或 者 gob 二 进 制 格式 将 数据 存储 在 文件 里 面 ， 可 以 对 
用 户 提交 的 文件 进行 处 理 ， 或 者 为 缓存 数据 提供 备份 。 

。 通过 使 用 database/sql 包 ， 可 以 对 关系 数据 库 执 行 CRUD 操 
作 ， 并 在 不 同 的 数据 之 间 建 立 起 相应 的 关系 。 

。 通过 Sqlx 和 Gorm 这 样 的 第 三 方 数据 访问 库 ， 可 以 使 用 威力 更 强大 
的 工具 去 操纵 数据 库 中 的 数据 。 


[1] 有 序 关 机 指 的 钙 等 到 所 有 任务 都 执行 完毕 之 后 ， 以 有 组 织 的 方式 关 
闭 计算 机 系统 ， 这 种 关机 可 以 确保 系统 在 重 局 之 后 不 会 丢失 任何 进度 
或 者 数据 。 一 一 译 者 注 


第 三 部 分 “实战 演练 


在 上 一 个 部 分 ， 我 们 学 习 了 如 何 编写 基本 的 服务 器 端 Web 应 用 ， 
但 这 些 知识 只 不 过 是 Web 应 用 开发 中 的 沧海 一 村 。 绝 大 多 数 现代 化 的 
Web 应 用 早已 超越 了 位 单 的 请 求 - 啊 应 模型 ， 并 以 多 种 不 同 的 形式 在 不 
断 地 演进 当中 。 比 如 ， 单 页 应 用 (Single Page Application, SPA) 和 移 
动 应 用 (无 论 是 原生 的 还 是 混合 的 ， 束 能 够 在 获取 Web 服 务 中 的 数据 
的 同时 ， 快 速 地 与 用 户 进行 交互 。 


在 本 书 的 最 后 一 部 分 ， 我 们 将 会 学 习 如 何 使 用 Go 语言 编写 能 够 为 
单 页 应 用 、 移 动 应 用 以 及 其 他 Web 应 用 提供 服务 的 Web 服 务 。 除 此 之 
外 ， 我 们 还 会 深入 了 解 Go 语言 强大 的 并 发 特性 ， 并 学 习 如 何 通过 并 发 
提高 Web 应 用 的 性 能 。 之 后 ， 我 们 会 了 解 Go 提 供 的 几 个 测试 工具 ， 并 
使 用 这 些 工 具 对 Web 应 用 进行 测试 。 


在 本 书 的 最 后 ， 我 们 将 会 学 习 如 何以 多 种 不 同 的 方式 部 署 Web 应 
用 ， 其 中 包括 只 需要 将 可 执行 二 进 制 文件 复制 到 目标 服务 嘎 的 简单 部 
车 方法， 以 及 需要 执行 一 系列 步骤 才能 将 Web 应 用 推送 到 云端 的 高 级 
部 警方 法 。 


第 7 章 Go Web 服 务 


本 章 主要 内 容 


。 使 用 REST 风 格 的 Web 服务 
。 使 用 Go 创建 和 分 析 XML 
。 使 用 Go 创建 和 分 析 JSON 
。 编写 Go Web 服 务 


正如 本 书 第 1 章 所 言 ，Web 服 务 就 是 一 个 向 其 他 软件 程序 提供 服务 
的 程序 。 本 章 将 扩展 这 一 定义 ， 并 展示 如 何 使 用 Go 语言 来 编写 或 使 用 
Web 服 务 。 因 为 XML 和 JSON 是 Web 服务 最 常 使 用 的 数据 格式 ， 所 以 我 
们 首先 会 学 习 如 何 创 建 以 及 分 析 这 两 种 数据 格式 ， 接 着 我 们 将 会 讨论 
SOAP 风 格 的 服务 以 及 REST 风 格 的 服务 ， 并 在 之 后 学 习 如 何 创 建 一 个 
使 用 JSON 传 输 数 据 的 简单 的 Web 服 务 。 


7.1 Web 服 务 简介 


通过 Go 语言 编写 的 Web 服 务 回 其 他 Web 服 务 或 应 用 提供 服务 和 效 
据 ， 是 Go 语言 的 一 种 第 见 的 用 法 。 所 谓 的 web 服务， 一 言 以 下 之 ， 驶 
是 一 种 与 其 他 软件 程序 进行 交互 的 软件 程序 。 这 也 就 是 说 ，Web 服 务 的 
终端 用 户 (end user) 不 是 人 类 ， 而 是 软件 程序 。 正 如 “Web 服 务 ”这 一 
名 字 所 暗示 的 那样 ， 这 种 软件 程序 是 通过 HTTP 进行 通信 的 ， 如 图 7-1 所 
Fie 


用 户 浏览 器 Web 应 用 


图 7-1 ”Web 应 用 与 Web 服 务 的 不 同 之 处 


有 趣 的 是 ， 虽 然 web 应 用 并 没有 一 个 确切 的 定义 ， 但 Web 服 务 的 定 
义 却 可 以 在 W3C 工 作 组 发 布 的 《Web 服 务 架构 》 (Web Service 
Architecture) 文档 中 找到 |; 


Web 服 务 是 一 个 软件 系统 ， 它 的 目的 是 为 网 络 上 进行 的 可 互 操作 机 器 
间 交 互 (interoperable machine-to-machine interaction) 提供 支持 。 每 个 Web 
服务 都 拥有 一 套 自己 的 接口 ， 这 些 接口 由 一 种 名 为 Web 服 务 描述 语言 (web 


service description language，WSDL) 的 机 器 可 处 理 格式 描述 。 其 他 系统 需 


要 根据 Web 服 务 的 描述 ， 使 用 SOAP 消 息 与 Web 服 务 交 互 。 为 了 与 其 他 Web 
相关 标准 实现 协作 ，SOAP 消 息 通常 会 被 序列 化 为 XML 并 通过 HTTP 传 输 。 


一 一 《Web 服务 架构 》，2004 年 2 月 11 日 | 


从 这 一 定义 来 看 ， 似 乎 所 有 Web 服 务 都 应 该 基于 SOAP 来 实现 ， 但 
实际 中 却 存在 着 多 种 不 同类 型 的 web 服务 ， 其 中 包括 基于 SOAP 的 、 基 
于 REST 的 以 及 基于 XML-RPC 的 ， 而 基于 REST 的 和 基于 SOAP 的 Web 服 
务 又 是 其 中 最 为 流行 的 。 企 业 级 系统 大 多 数 都 是 基于 SOAP 的 Web 服 务 
实现 的 ， 而 公开 可 访问 的 Web 服 务 则 更 青睐 基于 REST 的 Web 服 务 ， 本 
章 稍 后 将 会 对 此 进行 讨论 。 


基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 都 能 够 完成 相同 的 功 
能 ， 但 它们 各 目 也 拥有 不 同 的 长 处 。 基 于 SOAP 时 Web 服 务 出 现 的 时 间 
较 早 ，W3C 工 作 组 已 经 对 其 进行 了 标准 化 ， 与 之 相关 的 文档 和 资料 也 
非常 丰富 。 除 此 之 外 ， 很 多 企业 都 对 基于 SOAP 的 Web 服 务 提 供 了 强 有 
力 的 文 持 ， 并 且 基 于 SOAP 的 Web 服 务 还 拥有 数量 磊 丰 的 扩展 可 用 ( 因 
为 这 些 扩展 的 名 字 绝 大 多 数 都 是 像 WS-Security 和 WS-Addressing 这 样 以 
WS 为 前 缀 的 ， 所 以 这 些 扩展 被 统称 为 WS-*) 。 基 于 SOAP 的 服务 不 仅 
健壮 、 能 够 使 用 WwWSDL 进 行 明确 的 描述 、 拥 有 内 置 的 错误 处 理 机 制 ， 而 
且 还 可 以 通过 UUDI (Universal Description, Discovery, and Integration, 
统一 描述 、 发 现 和 集成 ) (一 种 目录 服务 ， 规范 发 布 。 


在 拥有 以 上 众多 优点 的 同时 ，SOAP 的 缺点 也 是 非常 明显 的 ， 它 不 
仅 笨 重 ， 而 且 过 于 复杂 。SOAP 的 XML 报 文 可 能 会 变 得 非常 见长 ， 导 致 
难以 调试 ， 使 用 户 只 能 通过 其 他 工具 对 其 进行 管理 ， 而 基于 SOAP 的 
Web 服 务 可 能 会 因为 额外 的 资源 损耗 而 无 法 高 效 地 运行 。 此 外 ，WSDL 


RRL Pi ARS a Z Ale GET EKARA, (ASA A HRE, 
BER REE: 为 了 对 Web 服 务 进行 更 新 ， 用 户 必 须 修改 WSDL， 而 
这 种 修改 又 会 引起 SOAP 客 户 端 发 生变 化 ， 最 终 导致 web 服务 的 开发 者 
即使 在 进行 最 细微 的 修改 时 ， 也 不 得 不 使 用 版 本 锁定 (version lock- 
in) 以 防止 发 生意 外 。 


跟 基 于 SOAP 的 Web 服 务 比 起 来 ， 基 于 REST 的 Web 服 务 就 显得 灵活 
多 了 。REST 本 冉 并 不 是 一 种 结构 ， 而 是 一 种 设计 理念 。 很 多 基于 
REST 的 Web 服 务 都 会 使 用 像 JSON 这 样 较为 简单 的 数据 格式 而 不 是 
XML， 从 而 使 Web 服 务 可 以 更 高 效 地 运行 ， 并且 基 于 REST 的 Web 服 务 
实现 起 来 通常 会 比 基 于 SOAP 的 Web 服 务 简单 得 多 。 


基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 的 另 一 个 区 别 在 于 ， 
前 者 是 功能 驱动 的 ， 而 后 着 是 数据 驱动 的 。 基 于 SOAP 的 Web 服 务 往往 
是 RPC (Remote Procedure Call， 远 程 过 程 调用 ) 风格 的 ; 但是， 正如 
之 前 所 说 ， 基 于 REST 的 Web 服 务 天 注 的 是 资源 ， 而 HTTP 方 法 则 是 对 这 
些 资源 执行 操作 的 动词 。 


ProgrammableWeb 是 一 个 流行 的 API 检 测 网 站 ， 它 会 对 互联 网 上 公 
开 可 用 的 API 进 行 检 测 。 在 编写 本 书 的 时 候 ，Programmableweb 的 数据 
库 搜 集 了 12 987 个 公开 可 用 的 API， 其 中 2 061 个 〈 占 比 16%) 为 基于 
SOAP 的 API， 而 6 967 个 〈 占 比 54%) 为 基于 REST 的 APII 。 可 惜 的 
是 ， 因 为 企业 很 少 会 对 外 发 布 与 内 部 Web 服 务 有 关 的 信息 ， 所 以 想 要 调 
查 清楚 各 种 web 服务 在 企业 中 的 使 用 情况 是 非常 困难 的 。 


为 了 满足 不 同 的 需求 ， 很 多 开发 者 和 公司 最 终 还 是 会 同时 使 用 基 
于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 。 在 这 种 情况 下 ，SOAP 将 


用 于 实现 内 部 应 用 的 企业 集成 (enterprise integration) ， 而 REST 则 用 
于 服务 外 部 以 及 第 三 方 的 开发 者 。 这 一 策略 的 优势 在 于 ， 它 最 大 限度 
地 利用 了 REST 《速度 快 并 且 构 建 简单 ) 以 及 SOAP (安全 并 且 健 壮 ) 
这 两 种 撤 术 的 优点 。 


7.2 ”基于 SOAP 的 Web 服务 简介 


SOAP 是 一 种 协议 ， 用 于 交换 定义 在 XML 里 面 的 结构 化 数据 ， 它 能 
够 跨越 不 同 的 网 络 协议 并 在 不 同 的 编程 模型 中 使 用 。SOAP 原 本 是 
Simple Object Access Protocol (简单 对 象 访问 协议 ) 的 首 字母 缩写 ， 但 
这 实际 上 有 是 一 个 名 不 符 实 的 名 字 ， 因 为 这 种 协议 处 理 的 并 不 是 对 象 ， 
并 且 时 至 今日 它 也 已 经 不 再 是 一 种 简单 的 协议 了 。 在 最 新 版 的 SOAP 
1.2 规 范 中 ， 这 种 协议 的 官方 名 称 仍然 为 SOAP， 但 它 已 经 不 再 代表 
Simple Object Access Protocol 1 ° 


因为 SOAP 不 仅 高 度 结构 化 ， 而 且 还 需要 严格 地 进行 定义 ， 所 以 用 
于 传输 数据 的 XML 可 能 会 变 得 非 第 复 沫 。WSDL 是 客 尸 痢 与 服务 絮 之 
间 的 契约 ， 它 定义 了 服务 提供 的 功能 以 及 提供 这 些 功能 的 方式 ， 服 务 
的 每 个 操作 以 及 输入 /输出 都 需要 由 WSDL 明 确 地 定义 。 


虽然 本 章 主 要 关注 的 是 基于 REST 的 Web 服 务 ， 但 出 于 对 比 需要 ， 
我 们 也 会 了 解 一 下 基于 SOAP 的 Web 服 务 的 运作 机 制 。 


SOAP 会 将 它 的 报 文 内 容 放 入 到 信封 (envelope) 里 面 ， 信 封 相当 
于 一 个 运输 容 需 ， 并 且 它 还 能 够 独立 于 实际 的 数据 传输 方式 存在 。 
为 本 书 只 会 对 SOAP Web 服 务 进 行 考察 ， 所 以 我 们 将 通过 HTTP 协 议 来 
说 明 被 传输 的 SOAP 报 文 。 


下 面 是 一 个 经 过 简化 的 SOAP 请 求 报 文 示例 : 


POST /GetComment HTTP/1.1 
Host: www.chitchat.com 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap:Envelope 
xmins:soap="http://www.w3.org/2001/12/soap-envelope" 


soap: encodingStyle="http: //www.w3.org/2001/12/soap -encoding"> 
<soap:Body xmlns:m="http://www.chitchat.com/forum"> 
<m:GetCommentRequest> 
<m: Comment Id>123</m: Comment Id> 
</m:GetCommentRequest > 
</ soap : Body> 
</soap:Envelope> 


因为 前 面 已 经 介绍 过 HTTP 报 文 的 首部 ， 所 以 这 里 给 出 的 HTTP 百 
部 对 你 来 说 应 该 不 会 感到 卫生 。 需 要 注意 的 是 ，Content -Type 的 值 
WAAR Sapplication/soap+xml ， 而 HTTP 请 求 的 主体 就 是 
SOAP 报 文本 身 ， 至 于 SOAP 报 文 的 主体 则 包含 了 请 求 报 文 。 在 这 个 例 
子 中 ， 报 文 请 求 的 是 ID 为 123 的 评论 : 


<m:GetCommentRequest> 
<m:CommentId>123</m:CommentId> 
</m:GetCommentRequest > 


这 条 SOAP 报 文 示例 经 过 了 简化， 实际 的 SOAP 请 求 通常 会 复杂 得 
多 。 下 面 展示 的 则 是 一 条 简化 后 的 SOAP 响 应 报 文 示例 : 


HTTP/1.1 200 OK 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap:Envelope 


xmlns:soap="http://www.w3.org/2001/12/soap-envelope" 
soap: encodingStyle="http: //www.w3.org/2001/12/soap -encoding"> 
<soap:Body xmlns:m="http://www.example.org/stock"> 

<m: GetCommentResponse> 

<m:Text>Hello World!</m:Text> 

</m: GetCommentResponse> 
</ soap : Body> 
</soap:Envelope> 


跟 请 求 报 文 一 样 ， 啊 应 报 文 也 被 包含 在 了 SOAP 报 文 的 主体 里 面 ， 
它 的 内 容 为 文本 “Hello World!”: 


<m: GetCommentResponse> 
<m:Text>Hello World!</m:Text> 


</m:GetCommentResponse> 


TEM EEF A, SRMAKHARGERS Re AS 
里 面 。 对 基于 SOAP 的 Web 服 务 来 说 ， 这 意味 着 它 传输 的 所 有 信息 都 会 
被 包 囊 在 SOAP 信 封 里 面 ， 然 后 再 发 送 。 顺 市 一 提 ， 虽 然 SOAP 1.2 人 允许 
通过 HTTP 的 GET 方法 发 送 SOAP 报 文 ， 但 大 多 数 基 于 SOAP 的 Web 服 务 
都 是 通过 HTTP 的 POST 方法 发 送 SOAP 报 文 的 。 


下 面 展 示 的 是 一 个 WSDL 报 文 示例 ， 这 种 报 文 不 仅 详细 ， 而 且 还 很 
了 见长 ， 即 使 对 稍 单 的 服务 来 说 也 站 如 此 。 基 于 SOAP 的 Web 服 务 之 所 以 
没有 基于 REST 的 Web 服 务 那 么 流行 ， 其 中 一 部 分 原因 融 与 此 有 关 一 一 
一 个 基于 SOAP 的 Web 服 务 越 复 沫 ， 它 对 应 的 WSDL 报 文 束 越 见长 。 


<?xml version="1.0" encoding="UTF-8"?> 

<definitions name ="ChitChat" 
targetNamespace="http://www.chitchat.com/forum.wsd1" 
xmins:tns="http://www.chitchat.com/forum.wsd1" 
xmlns:soap="http://schemas.xmlsoap.org/wsd1/soap/" 
xmins:xsd="http://www.w3.org/2001/XMLSchema" 


xmins="http://schemas.xmlsoap.org/wsd1/"> 
<message name="GetCommentRequest"> 
<part name="CommentiId" type="xsd:string"/> 
</message> 
<message name="GetCommentResponse"> 
<part name="Text" type="xsd:string"/> 
</message> 
<portType name="GetCommentPortType"> 
<operation name="GetComment"> 
<input message="tns:GetCommentRequest"/> 
<output message="tns:GetCommentResponse"/> 
</operation> 
</portType> 
<binding name="GetCommentBinding" type="tns:GetCommentPortType"> 
<soap:binding style="rpc" 
transport="http://schemas.xmlsoap.org/soap/http"/> 
<operation name="GetComment"> 
<soap:operation soapAction="getComment"/> 


<input> 
<soap:body use="literal"/> 
</input> 
<output> 
<soap:body use="literal"/> 
</output> 
</operation> 
</binding> 
<service name="GetCommentService" > 
<documentation> 
Returns a comment 
</documentation> 


<port name="GetCommentPortType" binding="tns:GetCommentBinding"> 
<soap:address location="http://localhost :8080/GetComment"/> 
</port> 
</service> 
</definitions> 


位 于 报 文 开头 的 是 报 文 对 自身 的 定义 ， 该 定义 给 出 了 报 文 各 个 浊 
分 的 名 字 ， 以 及 这 些 部 分 的 类 型 


<message name="GetCommentRequest"> 

<part name="CommentId" type="xsd:string"/> 
</message> 
<message name="GetCommentResponse"> 

<part name="Text" type="xsd:string"/> 


</message> 


在 此 之 后 ， 报 文通 过 GetComment 操作 定义 了 
GetCommentPortType 端口 ， 该 操作 的 输入 报 文 为 
GetCommentRequest ， 而 输出 报 文 则 为 GetCommentResponse : 


<portType name="GetCommentPortType"> 
<operation name="GetComment"> 
<input message="tns:GetCommentRequest"/> 


<output message="tns:GetCommentResponse"/> 
</operation> 
</portType> 


最 后 ， 报 文 在 位 置 http://localhost:8080/GetComment 定 义 了 一 个 
GetCommentService 服务 ， 并 将 它 与 GetCommentPortType 端口 
以 及 GetCommentsBinding 地 址 进行 绑 定 : 


<service name="GetCommentService" > 
<documentation> 
Returns a comment 
</documentation> 


<port name="GetCommentPortType" binding="tns:GetCommentBinding"> 
<soap:address location="http://localhost :8080/GetComment"/> 
</port> 
</service> 


在 实际 中 ，SOAP 请 求 报 文通 常会 由 WSDL 生 成 的 SOAP 客 户 端 负 
责 生成 ， 同 样 地 ，SOAP 了 响应 报 文通 常 也 是 由 WSDL 生 成 的 SOAP 服 务 
器 负责 生成 。 具 体 语言 的 客户 端 (如 一 个 Go SOAP 客 户 端 ) 通常 也 会 
由 WSDL 人 负责 生 成 ， 而 其 他 代码 则 会 通过 使 用 这 个 客户 端 与 服务 器 进行 
交互 。 这 样 做 的 结果 是 ， 只 要 WSDL 是 明确 定义 的 ， 那 么 它 生成 的 


SOAP Fini i EREA; 与 此 同时 ， 这 种 做 法 的 缺陷 是 ， 开 发 
员 每 次 修改 服务 器 ， 即 使 是 修改 返回 值 的 类 型 这 样 微小 的 修改 ， 客 

户 端 都 需要 重新 生成 。 重 复生 成 客户 端的 过 程 通常 都 是 风 长 而 乏味 

的 ， 这 也 解释 了 为 什么 SOAP Web 上 服务 通常 很 少 会 出 现 大 量 的 修改 一 一 

因为 对 大 型 的 SOAP Web 服 务 来 说 ， 频 繁 的 修改 将 是 一 场 嘱 梦 。 


本 章 接 下 来 不 会 再 对 基于 SOAP 的 Web 服 务 做 进一步 的 介绍 ， 但 我 
们 会 学 习 如 何 使 用 Go 语言 创建 以 及 分 析 XML 。 


7.3” 基 于 REST 的 Web 服 务 简介 


REST (Representational State Transfer， 具 象 状态 传输 ) 是 一 种 设 
计 理 念 ， 用 于 设计 那些 通过 标准 的 几 个 动作 来 操纵 人 资源， 并 以 此 来 进 
行 相互 交流 的 程序 (很 多 REST 使 用 者 都 会 把 操纵 资源 的 动作 称 为 “ 动 
词 ”， 也 就 是 verb) ° 


在 大 多 数 编程 范 型 里 面 ， 程 序 员 都 是 通过 定义 函数 然后 在 主 程序 
中 有 序 地 调用 这 些 函 数 来 完成 工作 的 。 在 面向 对 象 编程 (OOP) 范 型 
中 ， 程 序 员 要 做 的 事情 也 是 类 似 的 ， 主 要 的 区 别 在 于 ， 程 序 员 通过 创 
建 称 为 对 象 (object) 的 模型 来 表示 事物 ， 然 后 定义 称 为 方法 
(method) 的 函数 并 将 它们 附着 到 模型 之 上 。REST 是 以 上 思想 的 进化 
版 ,但 它 并 不 是 把 函数 暴露 (expose) 为 可 调用 的 服务 ， 而 是 以 资源 
(resource) 的 名 义 把 模型 暴露 出 来 ， 并 允许 人 们 通过 少数 几 个 称 为 动 
词 的 动作 来 操纵 这 些 资源 。 


在 使 用 HTTP 协 议 实 现 REST 服 务 时 ，URL 将 用 于 表示 资源 ， 而 
HTTP 方 法 则 会 用 作 操 纵 资 源 的 动词 ， 具 体 如 表 7-1 所 示 。 


表 7-1 使 用 HTTP 方 法 与 Web 服 务 进行 通信 


在 一 项 资源 尚未 存在 的 情况 下 创建 该 资源 


a 
ie 


刚 开 始 学 习 REST 的 程序 员 在 第 一 次 看 到 REST 使 用 的 HTTP 方 法 与 
数据 库 的 CRUD 操 作 之 间 的 映射 关系 时 ， 常 常会 对 此 感到 非常 惊奇 。 需 
要 注意 的 是 ， 这 种 映射 并 不 是 一 对 一 映射 ， 而 且 这 种 映射 也 不 是 唯一 
的 。 比 如 说 ， 在 创建 一 项 新 的 资源 时 用 户 既 可 以 使 用 POST ， 也 可 以 
使 用 PUT ， 这 两 种 做 法 都 符合 REST 风 格 。 


POST 和 PUT 的 主要 区 别 在 于 ， 在 使 用 PUT 时 需要 准确 地 知道 哪 一 
项 资源 将 会 被 蔡 换 ， 而 使 用 POST 只 会 创建 出 一 项 新 资源 以 及 一 个 新 
URL 。 换 名 话说，POST 用 于 创建 一 项 全 新 的 资源 ， 而 PUT 则 用 于 替换 
一 项 已 经 存在 的 资源 。 


正如 第 1 章 所 言 ，PUT 方法 是 时 等 的 ， 无 论 同一 个 调用 重复 执行 多 
少 次 ， 服 务 器 的 状态 都 不 会 发 生 任何 变化 。 无 论 是 使 用 PUT 创建 一 项 
货源 ， 还 是 使 用 PUT 修改 一 项 已 经 存在 的 资源 ， 给 定 的 URL 上 面 都 只 


ER 


会 有 一 项 资源 被 创建 出 来 。 相 反 地 ， 因 为 POST 并 不 是 害 等 的 ， 所 以 每 
调用 POST 一 次 ， 它 就 会 创建 一 项 新 资源 以 及 一 个 新 URL。 


对 刚 开 始 学 习 REST 的 程序 员 来 说 ， 另 一 个 需要 注意 的 地 方 是 ， 
REST 并 不 是 只 能 通过 表 7-1 提 到 的 4 个 HTTP 方 法 实现 ， 比 如 ， 不 太 常 见 
的 PATCH 方法 就 可 以 用 于 对 一 项 资源 进行 部 分 更 新 。 


下 面 是 一 个 REST 请 求 示例 : 


GET /comment/123 HTTP/1.1 


注意 ， 这 个 GET 请 求 并 没有 与 之 相关 联 的 主体 ， 而 与 这 个 GET 请 
求 相对 应 的 SOAP 请 求 则 正好 相反 : 


POST /GetComment HTTP/1.1 
Host: www.chitchat.com 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap:Envelope 
xmins:soap="http://www.w3.org/2001/12/soap-envelope" 


soap: encodingStyle="http: //www.w3.org/2001/12/soap -encoding"> 
<soap:Body xmlns:m="http://www.chitchat.com/forum"> 
<m:GetCommentRequest> 
<m: Comment Id>123</m: Comment Id> 
</m:GetCommentRequest > 
</ soap : Body> 
</soap:Envelope> 


这 是 因为 在 发 送 第 一 个 请 求 的 时 候 ， 我 们 使 用 了 HTTP 的 6ET 方法 
作为 动词 来 获取 资源 〈 在 这 个 例子 中 ， 资 源 就 是 一 条 博客 评论 ) 。 对 
于 这 个 GET 请 求 ， 即 使 web 服务 返回 一 个 SOAP 响 应 ， 它 也 会 被 认为 是 


一 个 REST 风 格 的 响应 : 这 是 因为 REST 跟 SOAP 不 同 ， 前 者 关注 的 是 

API 时 设计 ， 而 后 者 关注 的 则 是 被 发 送 报 文 的 格式 。 不 过 ， 因 为 SOAP 
报 文 构建 起 来 非常 麻烦 ， 所 以 人 们 在 使 用 REST API 的 时 候 通 常 都 是 返 
回 JSON， 或 者 返回 一 些 比 SOAP 报 文 要 人 简单 得 多 的 XML ， 而 很 少 会 返 
回 SOAP 报 文 。 


正如 WSDL 跟 SOAP 的 关系 一 样 ， 基 于 REST 的 Web 服 务 也 拥有 相应 
的 WADL (Web Application Description Language，Web 应 用 描述 语 
言 ) ， 这 种 语言 可 以 对 基于 REST 的 Web 服 务 进行 描述 ， 甚 至 能 够 生成 
访问 这 些 服 务 的 客户 端 。 但 是 跟 WSDL 不 同 的 是 ，WADL 没 有 得 到 广泛 
的 使 用 ， 也 没有 进行 标准 化 。 此 外 ，WADL 也 拥有 Swagger、RAML 

(Restful API Modeling Language，REST 风 格 API 建 模 语言 ) 和 JSON- 

home 这 样 的 同类 竞争 产品 。 

在 刚 开 始 接触 REST 的 时 候 ， 你 可 能 会 意识 到 这 种 设计 理念 非常 适 
用 于 那些 只 执行 简单 的 CRUD 操 作 的 应 用 ， 但 REST 是 否 适 用 于 更 为 复 
杂 的 服务 呢 ? 除 此 之 外 ， 它 又 是 如 何 对 过 程 或 者 动作 进行 建 模 的 呢 ? 

举 个 例子 ， 在 使 用 REST 设 计 的 情况 下 ， 一 个 应 用 要 如 何 才 能 激活 
一 个 用 户 的 账号 呢 ? 因 为 REST 只 允许 用 户 使 用 指定 的 几 个 HTTP 方 法 
操纵 资源 ， 而 不 允许 用 户 对 资源 执行 任意 的 动作 ， 所 以 应 用 是 无 法 发 
送 像 下 面 这 样 的 请 求 的 : 


ACTIVATE /user/456 HTTP/1.1 


有 一 些 办 法 可 以 绕 过 这 个 问题 ， 下 面 是 最 常用 的 两 种 方法 : 


(1) 把 过 程 具体 化 由， 或 者 把 动作 转换 成 名 词 ， 然 后 将 其 用 作 资 
着; 


(2) 将 动作 用 作 资 源 的 属性 。 
7.3.1 ”将 动作 转换 为 资源 


对 于 上 面 列 举 的 例子 ， 我 们 可 以 把 对 用 户 的 激活 动作 转换 为 对 资 
源 的 激活 动作 ， 然 后 通过 向 资源 发 送 HTTP 方 法 来 执行 激活 动作 ， 这 样 
一 来 ， 我 们 束 可 以 通过 以 下 方法 激活 指定 的 用 户 : 


POST /user/456/activation HTTP/1.1 


{ "date": "2015-05-15T13:05:05Z" } 


这 段 代 码 将 创建 一 个 被 激活 的 资源 (activation resource) ， 以 此 来 
表示 用 户 的 激活 状态 。 这 种 做 法 的 另 一 个 好 处 是 ， 它 可 以 为 被 激活 的 
资源 添加 额外 的 属性 。 比 如 ， 在 上 面 展 示 的 例子 中 ， 我 们 就 将 一 个 日 
期 附加 给 了 被 激活 的 资源 。 


7.3.2 ”将 动作 转换 为 资源 的 属性 


如 果 用 户 的 激活 与 否 可 以 通过 用 户 账号 的 一 个 状态 来 确定 ， 那 么 
我 们 只 需要 将 激活 动作 用 作 资 源 的 属性 ， 然 后 通过 HTTP 的 PATCH 方法 
对 该 资源 进行 部 分 更 新 即 可 ， 就 像 这 样 : 


PATCH /user/456 HTTP/1.1 


{ "active" : "true" } 


这 段 代 码 将 把 用 户 资源 的 active 属性 设置 为 true 。 
7.4 通过 Go 分 析 和 创建 XML 


在 对 SOAP 风 格 的 Web 服务 和 REST 风 格 的 web 服务 有 了 基本 的 了 解 
之 后 ， 接 下 来 就 让 我 们 看 看 Go 语言 是 如 何 实现 这 两 种 服务 的 。 首 先 ， 
本 节 会 介绍 如 何 创建 和 处 理 SOAP Web 服 务 会 用 到 的 XML 数据 ， 而 下 一 
节 则 会 介绍 如 何 创建 和 处 理 REST Web 服 务 会 用 到 的 JSON 数 据 。 


XML 可 以 以 结构 化 的 形式 表示 数据 ， 它 跟 本 书 前 面 提 a 到 的 HTML 
一 样 ， 都 是 一 种 流行 的 标记 语言 “XML 可 能 是 在 表示 、 发 送 和 接收 结 
构 化 数据 方面 使 用 最 广泛 的 一 种 格式 ， 这 种 格式 获得 了 W3C 组 织 的 正 
式 推 荐 ，W3C 发 布 的 XML 1.0 规 范 中 给 出 了 这 一 格式 的 具体 定义 。 


因为 我 们 经 常会 用 到 其 他 人 提供 的 web 服务 ， 或 者 需要 处 理 诸 如 
RSS 这 样 基于 XML 的 数据 源 ， 所 以 无 论 你 最 终 是 否 会 编写 或 使 用 Web 服 
务 ， 学 习 如 何 创建 和 分 析 XML 都 是 一 项 非常 重要 的 技能 。 即 使 你 不 需 
要 开发 自己 的 XML Web 服 务 ， 学 会 如 何 使 用 Go 与 XML 进行 交互 也 是 非 
常 有 用 的 一 件 事 。 比 如 说 ， 你 可 能 会 需要 从 一 个 RSS 新 闻 源 里 面 获取 数 
据 ， 并 将 其 用 作 自己 的 数据 源 之 一 。 在 这 种 情况 下 ， 你 必须 懂得 如 何 
分 析 XML 并 从 中 提取 出 自己 想 要 获取 的 信息 。 


无 论 是 使 用 XML、JSON 还 是 其 他 格式 ， 使 用 Go 语言 分 析 结 构 化 数 
据 的 方法 都 是 相似 的 。 对 XML 和 JSON 进 行 操作 需要 分 别 用 到 
encoding 库 中 的 XML 子 包 和 JSON 子 包 ， 现 在 ， 就 让 我 们 来 看 看 
encoding/xml 子 包 的 使 用 方法 。 


7.4.1 分 析 XML 


因为 分 析 XML 是 刚 开始 接触 XML 时 经 常会 做 的 一 件 事 ， 所 以 我 们 
就 以 学 习 如 何 分 析 XML 为 开始 。 在 Go 语言 里 面 ， 用 户 首先 需要 将 XML 
的 分 析 结 果 存 储 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 结构 来 获取 XML 
记录 的 数据 。 下 面 是 分 析 XML 时 常见 的 两 个 步骤 : 


(1) 创建 一 些 用 于 存储 XML 数据 的 结构 ; 


(2) 使 用 xm1L .Unmarshal 将 XML 数据 解 封 (unmarshal) 到 结 
构 里 面 ， 如 图 7-2 所 示 。 


图 7-2 使 用 Go 对 XML 进 行 分 析 : 将 XML 解 封 至 结构 
代码 清单 7-1 展 示 了 一 个 简单 的 XML 文件 post .xml ° 


代码 清单 7-1 一 个 简单 的 XML 文件 post . xml 


<?xml version="1.0" encoding="utf-8"?> 
<post id="1"> 
<content>Hello World!</content> 


<author id="2">Sau Sheong</author> 
</post> 


代码 清单 7-2 展 示 了 分 析 这 个 XML 所 需 的 代码 ， 这 些 代码 存储 在 文 
件 xm1.go 里 。 


代码 清 


7-2 ”对 XML 进行 分 析 


package main 


import ( 
"encoding/xml" 
"Fmt" 
"io/ioutil" 
Nos! 


) 


type Post struct { 
XMLName xml.Name 
Id string 
Content string 
Author Author 
Xml string 


//#A © 
`xml:"post"` 
`xml:"id,attr"` 
`xml:"content"` 
”xml:"author"” 
`xml:", innerxml"` 


} 


type Author struct { 
Id string `xml:"id,attr"` 
Name string xml:",chardata". 


} 


func main() { 
xmlFile, err := 
if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 


os.Open("post.xml") 


defer xmlFile.Close() 

xmlData, err := ioutil.ReadAll(xmlFile) 

if err != nil { 
fmt.Printin("Error reading XML data:", err) 
return 


} 


var post Post 
xml1.Unmarshal(xmlData, &post) 
fmt.Println(post ) 


© 


} 


@ 定义 一 些 结构 ， 用 于 表示 数据 


O 将 XML 数据 解 封 到 结构 里 面 


分 析 程 序 定义 了 用 于 表示 数据 的 Post 结构 和 Author 结构 。 因 为 
程序 想 要 在 获取 作者 信息 的 同时 也 获取 作者 信息 所 在 元 素 的 id 属性 ， 
所 以 程序 使 用 了 单独 的 Author 结构 来 表示 帖子 的 作者 ， 但 并 没有 使 用 
单独 的 Content 结构 来 表示 帖子 的 内 容 。 如 果 我 们 不 打算 获取 作者 信 
Aid 属性 ， 也 可 以 定义 一 个 下 面 这 样 的 Post 结构 ， 并 直接 使 用 字 
符 串 来 表示 帖子 的 作者 信息 〈 代 码 中 的 加 粗 行 ) : 


type Post struct { 
XMLName xml.Name ~xml:"post"~ 
Id string `xml:"id,attr"` 
Content string ‘xml:"content". 
Author string ~xml: "author" 


Xml string “xml: ",innerxml"~ 


Post 结构 中 每 个 字段 的 定义 后 面 都 带 有 一 段 使 用 反 引 号 CO 包 
围 的 信息 ， 这 些 信息 被 称 为 结构 标签 (struct tag) ，Go 语 言 使 用 这 些 
标签 来 决定 如 何 对 结构 以 及 XML 元素 进行 映射 ， 如 图 7-3 所 示 。 


结构 标签 


type Post struct { / N 


XMLName xml.Name `xml:"post"` 


Id string xml: "id, attr" 
Content string “xml: "content" ` 
Author Author `xml: "author" ` 
Xml string `xml:",innerxml" ` 


| T pg 


图 7-3 ”结构 标签 用 于 定义 XML 和 结构 之 间 的 映射 


结构 标签 古 一 些 跟 在 字段 后 面 ， 使 用 字符 串 表 示 的 键 值 对 ， 它 的 
键 是 一 个 不 能 包含 空格 、 引 号 (" ) 或 者 冒号 G) 的 字符 串 ， 而 值 则 
是 一 个 被 双 引 号 O") 包围 的 字符 串 。 在 处 理 XML 时 ， 结 构 标 签 的 键 


总 是 为 Xm1L ° 


为 什么 使 用 反 引 号 求 包 轩 结构 标 你 Otee | 


因为 Go 语言 使 用 双 引 号 〈"" ) 和 反 引 号 C) 来 包围 字符 串 ， 使 用 单 引号 C) 来 包围 
rune 《一 种 用 于 表示 Unicode 码 点 的 nt32 类 型 ) ， 并 且 因 为 结构 标签 内 部 已 经 使 用 了 双 引 号 
来 包围 键 的 值 ， 所 以 为 了 避免 进行 转 义 ，Go 语 言 就 使 用 了 反 引 号 来 包围 结构 标签 


出 于 创建 映射 的 需要 ，xml 包 要 求 被 映射 的 结构 以 及 结构 包含 的 
所 有 字段 都 必须 是 公开 的 ， 也 束 是 ， 它 们 的 名 字 必 须 以 大 写 的 英文 字 


母 开 头 。 以 上 面 展示 的 代码 为 例 ， 结 构 的 名 字 必 须 为 Post 而 不 能 是 
post ， 至 于 字段 的 名 字 则 必须 为 Content 而 不 能 是 content 。 


下 面 是 XML 结构 标签 的 其 中 一 些 使 用 规则 o 


(1) 通过 创建 一 个 名 字 为 XMLName 、 类 型 为 xm1L.Name 的 字 
段 ， 可 以 将 XML 元 素 的 名 字 存 储 在 这 个 字段 里 面 〈 在 一 般 情 况 下 ， 结 
构 的 名 字 就 是 元 素 的 名 字 ) 。 


(2) 通过 创建 一 个 与 XML 元 素 属 性 同名 的 字段 ， 并 使 用 'xml1:" 
<name >,attr" ' 作 为 该 字段 的 结构 标签 ， 可 以 将 元 素 的 <name > 属 
性 的 值 存储 到 这 个 字段 里 面 。 


(3) 通过 创建 一 个 与 XML 元 素 标签 同名 的 字段 ， 并 使 
用 'xml:",chardata"' 作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 素 的 
字符 数据 存储 到 这 个 字段 里 面 。 


(4) 通过 定义 一 个 任意 名 字 的 字段 ， 并 使 
用 'xml:",innerxml"' 作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 系 中 
的 原始 XML 存储 到 这 个 字段 里 面 。 


(5) 没有 模式 标志 (如 ,attr 、,chardata 或 者 , innerxml 
) 的 结构 字段 将 与 同名 的 XML 元 素 匹 配 。 


(6) 使 用 'xml:"a>b>c"' 这 样 的 结构 标签 可 以 在 不 指定 树 状 结 
构 的 情况 下 直接 获取 指定 的 XML 元 素 ， 其 中 a 和 b 为 中 间 元 素 ， 而 c 则 
是 想 要 获取 的 节点 元 素 。 


要 一 下 于 了 解 这 么 多 规则 并 不 容易 ， 特 别 是 对 最 后 几 条 规则 来 说 
更 是 如 此 ， 所 以 我 们 最 好 还 古来 看 一 些 实际 应 用 这 些 规 则 的 例子 。 


代码 清单 7-3 给 出 了 表示 帖子 XML 元 素 的 post 变量 及 其 对 应 的 
Post 结构 。 


代码 清单 7-3 ”用 于 表示 帖子 的 简单 的 XML 元 素 


<post id="1"> 
<content>Hello World!</content> 


<author id="2">Sau Sheong</author> 
</post> 


而 下 面 是 post 元 素 对 应 的 Post 结构 : 


type Post struct { 
XMLName xml.Name `xml:"post"` 
Id string `xml:"id,attr"` 
Content string ‘xml:"content". 
Author Author ~xml:"author"~ 
Xml string `xml:",innerxml"` 


} 


分 析 程 序 定义 了 与 XML 元 素 post 同名 的 Post 结构 ， 虽 然 这 种 做 
法 非常 常见 ， 但 是 在 某 些 时 候 ， 结 构 的 名 字 与 XML 元 素 的 名 字 可 能 
不 相同 ， 这 时 用 户 就 需要 一 种 方法 来 获取 元 素 的 名 字 。 为 此 ，xml 包 
提供 了 一 种 机 制 ， 使 用 户 可 以 通过 定义 一 个 名 为 XMLName 、 类 型 为 
xml. Name 的 字段 ， EE E KAI O pE 
字 。 在 Post AATF, X-MEN xml: "post"! 结构 
EPTC ELAN © ARTE ALI N ee 字段 存储 元 素 的 名 字 ”， 


分 析 程 序 将 元 素 的 名 字 post 存储 到 了 Post 结构 的 XMLName 字段 里 
面 。 


XML 元 素 post 拥有 一 个 名 为 id 的 属性 ， 根 据 规则 2 一 一 “使 用 结 
HIE xml:"&lt;name&gt;,`”``attr"`*``</code> 存 储 属性 
的 值 ”， 分 析 程序 通过 结构 标签 <code> xml:"id,attr"` 将 id 属 
性 的 值 存 储 到 了 Post 结构 的 Id 字段 里 面 。 


post 元 素 包 含 了 一 个 content 子 元 素 ， 这 个 子 元 素 没 有 属性 ， 
但 它 包 含 了 字符 数据 Hello World! ， 根 据 规则 5 一 一 “没有 模式 标志 
的 结构 字段 将 与 同名 的 XML 元 素 进行 匹配 ”， 分 析 程 序 通过 结构 标 
签 'xml:"content"' content 子 元 素 包 含 的 字符 数据 存储 到 了 
Post 结构 的 Content 字段 里 面 。 


根据 规则 4 一 一 “使 用 结构 标签 'xml:", innerxml"' 可 以 获取 原 
人 XML”， 分 析 程 序 定义 了 一 个 Xml1 字段 ， 并 使 
用 'xml:",innerxml"' 作为 该 字段 的 结构 标签 ， 以 此 来 获得 被 post 
元 素 包 含 的 原始 XML: 


<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 


子 元 素 author 拥有 id 属性 ， 并 且 包 含 字 符 数 据 Sau Sheong ， 
为 了 正确 地 构建 映射 ， 分 析 程 序 专门 定义 了 Author 结构 : 


type Author struct { 
Id string ~xml:"id,attr"~ 


Name string ~xml:",chardata"~ 


} 


根据 规则 5，author FERRIE T HA 'xml: "author"! 
结构 标签 的 Author 字段 。 在 Author 结构 中 ， 属 性 id 的 值 被 映射 到 
了 带 有 'xml:"id,attr"' 结构 标签 的 Id 字段 ， 而 字符 数据 Sau 
Sheong 则 被 映射 到 了 带 有 'xml:",chardata"' 结构 标签 的 Name 
字段 。 


俗话 说 ， 百 闻 不 如 一 见 。 在 详细 了 解 了 整个 分 析 程 序 之 后 ， 接 下 
来 束 让 我 们 实际 运行 一 下 这 个 程序 。 在 终端 里 面 执 行 以 下 命令 : 


如 琳 一 切 正常 ， 这 一 命令 应 该 会 运 回 以 下 结 


{{ post} 1 Hello World! {2 Sau Sheong} 
<content>Hello World!</content> 


<author id="2">Sau Sheong</author> 


让 我 们 逐一 地 分 析 这 些 结果 。 首 先 ， 因 为 post 变量 是 Author 245 
构 的 一 个 实例 ， 所 以 整个 结果 都 被 包围 在 了 一 对 大 括号 ({} ) 里 面 。 
post 结构 的 第 一 个 字段 是 另 一 个 类 型 为 xm1L ,Name 的 结构 ， 这 个 结构 
在 结果 中 表示 为 { post }。 在 此 之 后 展示 的 数字 1 Ald 字段 的 值 ， 
而 "Hello World!" 则 是 Content 字段 的 值 。 再 之 后 展示 的 是 存储 


在 Author 结构 里 面 的 内 容 ，{2 Sau Sheong}。 结 果 最 后 展示 的 是 
XML 元 素 post 内 部 包含 的 原始 XML 。 


前 面 的 内 容 列举 了 规则 1 至 规则 5 的 使 用 示例 ， 现 在 让 我 们 来 看 看 
规则 6 是 如 何 运 作 的 。 规 则 6 声称 ， 使 用 结构 标签 'xml:"a>b>c"'， 
可 以 在 不 指定 树 状 结构 的 情况 下 ， 越 过 中 间 元 素 a 和 b 直接 访问 节点 元 
Ac 。 


代码 清单 7-4 展 示 的 是 另 一 个 XML 示例 ， 这 个 XML 也 存储 在 名 为 
post .xml 的 文件 中 。 


代码 清单 7-4 市 有 舱 均 元 系 的 XML 文件 


< ?xml version="1.0" encoding="utf-8"?> 
< post id="1"> 
< content>Hello World!< /content> 
< author id="2">Sau Sheong< /author> 
< comments> 


< comment id="1"> 


< content>Have a great day!< /content> 


< author id="3">Adam< /author> 


< /comment> 


< comment id="2"> 


< content>How are you today?< /content> 


< author id="4">Betty< /author> 


< /comment> 


< /comments> 


< /post> 


这 个 XML 文件 的 前 半 部 分 内 容 跟 之 前 展示 的 XML 文件 是 相同 的 ， 
而 加 粗 显 示 的 则 是 新 出 现 的 代码 ， 这 些 新 代码 定义 了 一 个 名 为 
comments 的 XML 子 元 隶 ， 并 且 这 个 元 素 本 喘 也 包含 多 个 comment F 
元 素 。 这 一 次 ， 分 析 程 序 需 要 获取 帖子 的 评论 列表 ， 但 为 此 专门 创建 
一 个 Comments 结构 可 能 会 显得 有 些小 题 大 做 了 。 为 了 简化 实现 代 
码 ， 分 析 程 序 将 根据 规则 6 对 comments 这 个 XML 子 元 素 进 行 跳跃 式 访 
问 。 代 码 清单 7-5 展 示 了 经 过 修改 的 Post 结构 ， 修 改 后 的 Post 结构 带 
有 新 增 的 字段 以 及 实现 跳跃 式 访问 所 需 的 结构 标签 。 


代码 清单 7-5 ” 带 有 comments 结构 字段 的 Post 结构 


type Post struct { 
XMLName xml.Name `xml:"post"` 
Id string `xml:"id,attr"` 
Content string `xml: "content" ` 
Author Author `xml: "author" ` 


Xml string `xml:", innerxml"` 
Comments []Comment ~xml:"comments>comment"~ 


TEM ARIS FA DUET AAS, OP TREE A T REAP eI ZB , 
在 Post 结构 中 增加 了 类 型 为 Comment 结构 切片 的 Comments 字段 ， 


并 通过 结构 标签 'xml:"comments>comment"' 将 这 个 字段 映射 至 名 
为 comment 的 XML 子 元 素 。 根 据 规 则 6， 这 一 结构 标签 将 允许 分 析 程 
序 跳 过 XML 中 的 comments 元 素 ， 直 接 访 问 comment FA ° 


Comment 结构 和 Post 结构 非常 相似 ， 它 的 具体 定义 如 下 : 


type Comment struct { 
Id string `xml:"id,attr"` 
Content string ~xml:"content"~ 


Author Author ~xml:"author"~ 


} 


TEEN T HITRE DT Pe ZA RR RA Za, MEE 
候 将 XML 数据 解 封 到 这 些 结构 里 面 了 。 因 为 负责 执行 解 封 操作 的 
Unmarshal 函数 只 接受 字 节 切片 〈 也 就 是 字符 串 ) 作为 参数 ， 所 以 分 
析 程 序 首 先 要 做 的 就 是 将 XML 文 件 转换 为 字符 串 ， 这 一 操作 可 以 通过 
以 下 代码 来 实现 (在 执行 这 些 代码 时 ，XML 文 件 必 须 与 Go 文件 处 于 同 
a IE 


xmlFile, err := os.Open("post.xml") 

if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 


} 
defer xmlFile.Close() 


xmlData, err := ioutil.ReadAll(xml1File) 

if err != nil { 
fmt.Println("Error reading XML data:", err) 
return 


在 将 XML 文 件 的 内 容 读 取 到 xmlData 变量 里 面 之 后 ， 分 析 程 序 可 
以 通过 执行 以 下 代码 来 解 封 XML 数据 : 


Var post Post 
xml1.Unmarshal(xmlData, &post) 


如 果 你 曾经 使 用 其 他 编程 语言 分 析 过 XML ， 那 么 你 应 该 会 知道 ， 
这 种 做 法 虽然 能 够 很 好 地 处 理 体积 较 小 的 XML 文件 ， 但 是 却 无 法 高 效 
地 处 理 以 流 (stream) 方式 传输 的 XML 文件 以 及 体积 较 大 的 XML 文 
件 。 为 了 解决 这 个 问题 ， 我 们 需要 使 用 Decoder 结构 来 代替 
Unmarshal 函数 ， 通 过 手动 解码 XML 元 素 的 方式 来 解 封 XML 数据 ， 
这 个 过 程 如 图 7-4 所 示 。 


图 7-4 使 用 Go 分 析 XML: 将 XML 解码 至 结构 


代码 清单 7-6 展 示 了 如 何 使 用 Decoder 分 析 前 面 提 到 的 XML 文 
ir 


代码 清单 7-6 使 用 Decoder 分 析 XML 


package main 


import ( 
"encoding/xml" 
" fmt " 


) 
type Post struct { 


XMLName xml.Name ~xml:"post"~ 


Id string “xml: "id,attr"” 
Content string xml:"content". 
Author Author xml:"author". 
Xml string `xml:", innerxml"” 


Comments []Comment ~xml:"comments>comment"~ 


} 


type Author struct { 
Id string `xml:"id,attr"` 
Name string `xml:",chardata"` 


} 


type Comment struct { 
Id string `xml:"id,attr"` 
Content string `xml:"content"` 
Author Author ‘xml:"author". 


F 


func main() < 
xmlFile, err := os.Open("post.xml") 
if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 


} 
defer xmlFile.Close() 


decoder := xml.NewDecoder(xmlFile) @ 
for { © 
t, err := decoder.Token() © 
if err == io.EOF { 
break 
} 
if err != nil { 
fmt.Printin("Error decoding XML into tokens:", err) 
return 


} 


switch se := t.(type) { 0 
case xml.StartElement: 
if se.Name.Local == "comment" { 
var comment Comment 
decoder .DecodeElement(&comment, &se) © 


} 
} 
} 


| 
O 根据 给 定 的 XML Bae BOTA hy AREAS as 
O BIAS ae FAT XML 数据 


© BT VAIN, MME an E MRA — A token 


gy 


@ 检查 token 的 类 型 


O 将 XML 数据 解码 至 结构 


虽然 这 段 代码 只 演示 了 如 何 解码 comment 元 素 ， 但 这 种 解码 方式 
同样 可 以 应 用 于 XML 文件 中 的 其 他 元 素 。 这 个 新 的 分 析 程 序 会 通过 
Decoder 结构 ， 一 个 元 素 接 一 个 元 素 地 对 XML 进 行 解码 ， 而 不 是 像 之 
前 那样 ， 使 用 Unmarshal 函数 一 次 将 整个 XML 人 解 封 为 字符 串 。 


对 XML 进行 解码 首先 需要 创建 一 个 Decoder ， 这 一 点 可 以 通过 调 
用 NewDecoder 并 向 其 传递 一 个 io .Reader 来 完成 。 在 上 面 展示 的 
代码 清单 中 ， 程 序 就 把 os ,0pen 打开 的 xmLFile 文件 传递 给 了 


NewDecoder ° 


在 拥有 了 解码 器 之 后 ， 程 序 就 会 使 用 Token 方法 来 获取 XML 流 中 
的 下 一 个 token: 在 这 种 情景 下 ，token 实 际 上 丈 是 一 个 表示 XML 元 素 的 
接口 。 为 了 从 解码 器 里 面 取出 所 有 token， 程 序 使 用 一 个 无 限 for 循环 
包 焉 起 了 从 解码 故里 面 获取 token 的 相 天 动作 。 当 解码 器 包含 的 所 有 
token 都 已 被 取出 时 ，Token 方法 将 返回 一 个 表示 文件 数据 或 数据 流 已 


被 读 取 完 毕 的 io ,EOF 结构 作为 结果 ， 并 将 返回 值 中 的 err 变量 的 值 
设置 为 nil e° 


分 析 程 序 从 解码 器 里 取出 token 之 后 会 对 该 token 进 行 检查 以 确认 其 
是 否 为 StartElement ， 也 就 是 ， 判 断 该 token 古 否 为 XML 元 素 的 起 
台 标签 。 如 果 是 的 话 ， 那 么 程序 会 继续 对 这 个 token 进 行 检查 ， 看 它 是 
否 束 是 XML 中 的 comment 元 素 。 在 确认 了 目 己 过 到 的 是 comment 元 
素 之 后 ， 程 序 就 会 将 整个 token 解 码 至 Comment 结构 ， 从 而 得 到 与 解 老 
XML 元 素 相 同 的 结 


因为 手动 解码 XML 文件 需要 做 更 多 工作 ， 所 以 这 种 方法 并 不 适用 
于 处 理 小 型 的 XML 文件 。 但 如 果 程 序 面 对 的 是 流 式 XML 数 据 ， 或 者 体 
积 非常 庞大 的 XML 文件 ， 那 么 解码 将 是 从 XML 里 提取 数据 唯一 可 行 的 
办 法 。 


在 结束 本 小 方 并 转向 讨论 如 何 创建 XML 之 前 ， 还 有 一 点 需要 说 明 
一 下 ， 那 就是 :本 市 介绍 的 分 析 规 则 只 古 XML 分 析 规 则 的 一 部 分 ， 如 
条 你 想 要 更 详细 地 了 解 这 些 规则 ， 可 以 去 查看 xml 库 的 文档 ， 或 者 直 
接 阅 读 xml 库 的 源码 。 


7.4.2 ”创建 XML 


在 上 一 万 中， 我 们 花 了 不 少时 间 学 习 如 何 分 析 XML ， 驻 运 的 是 ， 
因为 创建 XML 正 好 就 是 分 析 XML 的 逆 操 作 ， 所 以 上 一 市 介绍 的 知识 在 
本 市 也 是 适用 的 。 在 上 一 市 中 ， 我 们 学 习 的 十 怎样 把 XML 解 封 到 结构 
里 面 ， 而 这 一 节 我 们 要 学 习 的 则 是 怎样 把 Go 结构 封装 (marshal) 至 


XML; 同样 ， 上 一 太 我 们 学 习 的 是 怎样 把 XML 人 解码 至 Go 结构 ， 而 本 市 
我 们 要 学 习 的 则 是 怎样 把 Go 结构 编码 至 XML ， 这 个 过 程 如 图 7-5 所 示 。 


图 7-5 ”使 用 Go 创建 XML: 创建 结构 并 将 其 封装 至 XML 


首先 让 我 们 来 看 看 封装 操作 是 如 何 进行 的 。 代 码 请 单 7-7 展 示 了 文 
件 xml.go 包含 的 代码 ， 这 些 代码 会 创建 一 个 名 为 post .xml 的 XML 
Se 


代码 清单 7-7 使 用 Marshal 函数 生成 XML 文 件 


package main 


import ( 
"encoding/xm1" 
"Fmt " 
"io/ioutil" 


) 


type Post struct { 
XMLName xml.Name `xml:"post"` 
Id string `xml:"id,attr"` 
Content string `xml:"content"` 
Author Author ”xml:"author"” 


} 


type Author struct { 
Id string ~xml:"id,attr"~ 
Name string ~xml:",chardata"~ 


func main() { 
post := Post{ 
Id: ae Ds 


Content: " Hello World!", @ 
Author: Author{ 

Id: he 

Name: "Sau Sheong", 


F 


} 


output, err := xml.Marshal(&post) 

if err != nil { © 
fmt.Println("Error marshalling to XML:", err) 
return 


} 
err = ioutil.WriteFile("post.xml", output, 0644) 


if err != nil { 
fmt.Println("Error writing XML to file:", err) 
return 

} 


@ 创 建 结构 并 向 里 面 填充 数据 


@ 把 结构 封 婆 为 由 子 广 切 片 组 成 的 XML 数据 


正如 代码 所 示 ， 封 装 XML 和 解 封 XML 时 使 用 的 结构 以 及 结构 标签 
征 完 全 相同 的 : 封 小 操作 只 不 过 是 把 处 理 过 程 反 转 了 过 来 ， 然 后 根据 
结构 创建 相应 的 XML 于 了 。 封 装 程 序 首 允 需要 创建 表示 帖子 的 post 结 
构 ， 并 癌 结 构 里 面 填充 数据 ， 然 后 只 要 调用 Marshal wa, Win LAR 
据 Post 结构 创建 相应 的 XML 了 。 作 为 例子 ， 下 面 束 是 Marshal 函数 
根据 Post 结构 创建 出 的 XML 数据 ， 这 些 数据 包含 在 了 post .xml X 
件 里 面 : 


<post id="1"><content>Hello World!</content><author id="2">Sau 


Sheong</author></post> 


虽然 样子 并 不 是 特别 好 看 ， 但 函数 生成 出 来 的 的 的 确 确 就 是 一 段 
XML ° 如果 想 要 让 程序 生成 更 好 看 的 XML， 那 么 可 以 使 用 
MarshalIndent 函数 代 共 Mar shal WR: 


output, err := xml.MarshalIndent(&post, "", "\t") 


MarshalIndent 函数 跟 Marshal 函数 一 样 ， 都 接受 一 个 指向 结 
构 的 指针 作为 自己 的 第 一 个 参数 ， 但 除 此 之 外 ，MarshalIndent Kj 
数 还 接受 两 个 额外 的 参数 ， 这 两 个 参数 分 别 用 于 指定 添加 a 到 每 个 输出 
行 前 面 的 前 缀 以 及 缩 进 ， 其 中 缩 进 的 数量 会 随 着 元 素 的 岁 套 层次 增加 
而 增加 。 在 处 理 相 同 的 Post 结构 时 ，MarshalIndent 函数 将 产生 以 
下 更 为 美观 的 输出 : 


<post id="1"> 
<content>Hello World!</content> 


<author id="2">Sau Sheong</author> 
</post> 


因为 这 段 XML 缺 少 了 XML 声明 ， 所 以 从 格式 上 来 说 这 段 XML 并 不 
完全 正确 。 虽 然 xml 库 不 会 自动 为 Marshal 或 者 MarshalIndent Æ 
成 的 XML 添 加 XML 声 明 ， 但 用 户 可 以 很 轻易 地 通过 xml1 .Header 常量 
将 XML 声 明 添 加 到 封装 输出 之 前 : 


err = ioutil.WriteFile("post.xml", []byte(xml.Header + 


string(output)), 0644) 


通过 把 xm1 .Header 添加 到 输出 结果 之 前 ， 并 将 这 些 内 容 全 部 写 
入 post .xml 文件 ， 我 们 就 得 到 了 一 段 带 有 XML 声 明 的 XML: 


<?xml version="1.0" encoding="UTF-8"?> 
<post id="1"> 


<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 
</post> 


正如 我 们 可 以 手动 将 XML 解码 到 Go 结构 里 面 一 样 ， 我 们 同样 可 以 
手动 将 Go 结构 编码 到 XML 里 面 ， 图 7-6 展 示 了 这 个 过 程 ， 代 码 清单 7-8 
则 展示 了 一 个 简单 的 编码 示例 。 


创建 结构 并 创建 用 于 存储 XML 创建 用 于 编码 通过 编码 器 把 结 
向 其 填充 数据 数据 的 XML 文件 结构 的 编码 器 构 编码 至 XML 文件 


图 7-6 ”使 用 Go 创建 XML: 通过 使 用 编码 器 来 将 结构 编码 至 XML 


代码 清单 7-8 手动 将 Go 结构 编码 至 XML 


package main 


import ( 
"encoding/xml" 
UL! fmt " 
UL! os " 


) 


type Post struct { 
XMLName xml.Name `xml:"post"` 


Id string `xml:"id,attr"` 
Content string `xml:"content"` 
Author Author `xml:"author"` 


} 


type Author struct { 


Id string `xml:"id,attr"` 
Name string `xml:",chardata"` 


} 


func main() { 
post := Post{ 
Id: "1", @ 
Content: "Hello World!", 
Author: Author{ 


Id: oN 
sg / 
Name: "Sau Sheong", 
ty 
} 
xmlFile, err := os.Create("post.xml") © 
if err != nil { 
fmt.Println("Error creating XML file:", err) 
return 
encoder := xml.NewEncoder(xmlFile) © 


encoder.Indent("", "\t") 
err = encoder.Encode(&post) © 


if err != nil { 
fmt.Printin("Error encoding XML to file:", err) 
return 


@ 创建 结构 并 向 里 面 填充 数据 


@ 创建 用 于 存储 数据 的 XML 文件 
© 根据 给 定 的 XML 文件 ， 创 建 出 相应 的 编码 絮 
@ 把 结构 编码 至 文件 


跟 之 前 一 样 ， 程 序 首 先 创建 了 将 要 被 编码 的 Post 结构 ， 接 着 通过 
os.Create 创建 出 了 将 要 写 入 的 XML 文件 ， 然 后 使 用 NewEncoder 
函数 创建 了 一 个 包 庄 着 XML 文件 的 编码 器 。 在 设置 好 相应 的 前 缀 和 缩 


进 之 后 ， 程 序 就 会 使 用 编码 器 的 Encode 方法 对 传 入 的 Post 结构 进行 
编码 ， 最 终 创 建 出 包含 以 下 内 容 的 post .xml 文件 : 


<post id="1"> 


<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 
</post> 


通过 这 一 万 的 学 习 ， 读 者 应 该 已 经 了 解 了 如 何 分 机 和 创建 XML © 
需要 注意 的 是 ， 本 市 讨论 的 只 是 分 析 和 创建 XML 的 基础 知识 ， 如 果 想 
要 知道 关于 这 方面 的 更 多 信息 ， 可 查看 相应 的 文档 以 及 源码 ( 别 担 
心 ， 阅 读 源码 并 没有 想象 中 那么 可 怕 ) 。 


7.5 ”通过 Go 分 析 和 创建 JSON 


JSON (JavaScript Object Notation) 是 衍生 自 JavaScript 语 言 的 一 种 
轻 量 级 的 文本 数据 格式 ， 这 种 格式 的 主要 设计 理念 是 既 能 够 轻易 地 被 
AREE, XEEN RHL E e JSON H Douglas Crockford 
定义 ， 现 在 则 由 RFC 7159 和 ECMA-404 描 述 。 虽 然 接 受 和 返回 JSON 数 
据 并 不 是 实现 REST Web 服 务 的 唯一 选择 ， 但 大 多 数 REST Web 服 务 都 
是 这 样 做 的 。 


在 与 REST Web 服 务 打交道 的 时 候 ， 我 们 常常 会 以 某 种 形式 与 
JSON 不 期 而 遇 ， 要 么 就 是 为 了 创建 JSJON， 要 么 就 是 为 了 处 理 JSON， 
LEMNE EA ° 处理 JSON 在 Web 应 用 中 非常 常见 : 无 论 是 从 Web 服 
务 里 面 获 取 数 据 ， 还 是 通过 第 三 方 号 份 验证 服务 登录 Web 应 用 ， 又 或 者 
对 其 他 服务 进行 控制 ， 通 党 都 需要 处 理 JSON 数 据 。 


ERSERISON—IF, B@ISONLIF HT iL: Go 语言 经 常会 被 用 于 
创建 为 前 端 应 用 提供 服务 的 web 服务 后 端 ， 其 中 就 包括 基于 JavaScript 
的 前 端 应 用 ， 而 这 些 应 用 常 冲 会 运行 着 Reactjs 和 Angularjs 这 样 的 
JavaScript 库 。 除 此 之 外 ，Go 语 言 还 会 被 用 于 为 物 联网 以 及 诸如 智能 手 
表 这 样 的 可 穿戴 设备 创建 Web 服 务 。 因 为 在 很 多 情况 下 ， 这 些 前 端 应 用 
都 是 基于 JSON 开 发 的 ， 所 以 它们 与 后 端 进行 交互 最 自然 的 方式 当然 也 
是 使 用 JSON ° 


正如 Go 语言 提供 对 XML 的 支持 一 样 ，Go 语 言 也 通过 
encoding/json 库 提 供 对 JSON 的 支持 。 和 上 一 节 一 样 ， 我 们 首先 会 
学 习 如 何 分 析 JSON， 然 后 再 学 习 如 何 创建 JSON 数 据 。 


7.5.1 分 析 JSON 


分 析 JSON 的 步 又 和 分 析 XML 的 步 又 基本 相同 一 一 分 析 程 序 首先 要 
做 的 束 是 把 JSON 的 分 析 结 来 存储 a 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 
结构 来 提取 数据 。 下 面 是 分 析 JSON 的 两 个 常见 步骤 (这 个 过 程 如 图 7-7 
FRAN): 


图 7-7 使 用 Go 分 析 JSON: 创建 结构 并 将 JSON 解 封 到 结构 里 面 


(1) 创建 一 些 用 于 包含 JSON 数 据 的 结构 


(2) 通过 json .Unmarshal 函数 ， 把 JSON 数 据 解 封 到 结构 里 
面 。 


跟 映 射 XML 相 比 ， 把 结构 映射 至 JSON 要 简单 得 多 ， 后 者 只 有 一 条 
通用 的 规则 ， 对 于 名 字 为 <name> 的 JSON 键 ， 用 户 只 需要 在 结构 里 创 
建 一 个 任意 名 字 的 字段 ， 并 将 该 字段 的 结构 标签 设置 为 'json:" 
<name>"'， 就 可 以 把 JSON 键 <name> 的 值 存储 到 这 个 字段 里 面 。 接 
下 来 ， 就 让 我 们 来 看 一 个 实际 的 例子 。 


代码 清单 7-9 展 示 了 一 个 名 为 post ,json 的 JSON 文 件 ， 我 们 接 下 
来 就 要 对 这 个 文件 进行 分 析 。 因 为 这 个 JSON 文 件 包含 的 数据 跟 之 前 分 
析 的 XML 文件 包含 的 数据 是 相同 的 ， 所 以 这 些 数据 对 你 来 说 应 该 不 会 
感到 陌生 。 


代码 清单 7-9 ”要 分 析 的 JSON 文 件 


"id" : 1, 
"content" : "Hello World!", 
"author" : { 
nid 2; 
"name" : "Sau Sheong" 
A 
"comments" : [ 
{ 
Tad A3; 
"content" : "Have a great day!", 
"author" : "Adam" 
ty 
{ 
"id" : 4, 
"content" : "How are you today?", 
"author" : "Betty" 


| 

代码 清单 7-10 展 示 了 json. go 文件 包含 的 代码 ， 这 些 代 码 会 分 析 
post .json 文件 ， 并 将 其 包含 的 JSON 数 据 解 封 至 相应 的 结构 。 需 
注意 的 是 ， 除 了 结构 标签 之 外 ， 这 个 程序 使 用 的 结构 跟 之 前 分 析 XML 
时 使 用 的 结构 并 无 不 同 。 


代码 清单 7-10 ” JSON 分 析 程 序 


package main 


import ( 
"encoding/json" 
"Fmt" 
"io/ioutil" 
Nos! 
) 
type Post struct { 
Id int ”json:"id"" @ 
Content string ~json: "content" 
Author Author ~json: "author" ` 


Comments []Comment ~json:"comments"~ 


type Author struct { 
Id int json:"id". 
Name string ~json:"name"~ 


} 


type Comment struct { 
Id int “json: "id"~ 
Content string ~“json:"content"~ 
Author string ~json:"author"~ 


func main() { 


jsonFile, err := os.Open("post.json") 

if err != nil 
fmt.Println("Error opening JSON file:", err) 
return 


} 


defer jsonFile.Close() 

jsonData, err := ioutil.ReadAll(jsonFile) 

if err != nil { 
fmt.Printin("Error reading JSON data:", err) 
return 


} 


var post Post 
json.Unmarshal(jsonData, &post) @ 
fmt.Println(post ) 


@ 定义 一 些 结构 ， 用 于 表示 数据 


@ 将 JSON 数据 解 封 至 结构 

为 了 将 JSON 键 id 的 值 映 射 到 Post 结构 的 Id 字段 ， 程 序 将 该 字 
段 的 结构 标签 设置 成 了 'json:"id"'， 这 种 设置 基本 上 就 是 将 结构 映 
射 至 JSON 数 据 所 需 完 成 的 全 部 工作 。 跟 分 析 XML 时 一 样 ， 分 析 程 序 通 
过 切片 来 娩 套 多 个 结构 ， 从 而 使 一 篇 帖子 可 以 包含 零 个 或 多 个 评论 。 
除 此 之 外 ，JSON 的 解 封 操作 也 跟 XML 的 解 封 操作 一 样 ， 都 可 以 通过 调 
用 Unmarshal 函数 来 完成 。 


我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 分 析 程 序 : 


如 果 一 切 正 常 ， 应 该 会 看 到 以 下 结 


{1 Hello World! {2 Sau Sheong} [{3 Have a great day! Adam} {4 How 


are you today? Betty}]} 


跟 分 析 XML 时 一 样 ， 用 户 除了 可 以 使 用 Unmarshal KARHE 
JSON， 还 可 以 使 用 Decoder 手动 地 将 JSON 数 据 解码 到 结构 里 面 ， 以 
此 来 处 理 流 式 的 JSON 数 据 ， 图 7-8 以 及 代码 清单 7-11 展 示 了 这 个 过 程 的 
具体 实现 。 


图 7-8 ”使 用 Go 分 析 JSON: 将 JSON 解 码 至 结构 


代码 清单 7-11 ”使 用 Decoder 对 JSON 进 行 语言 分 析 


jsonFile, err := os.Open("post.json") 

if err != nil { 
fmt.Printin("Error opening JSON file:", err) 
return 


defer jsonFile.Close( ) 


decoder := json.NewDecoder(jsonFile) ©@ 
for { © 
var post Post 
err := decoder.Decode(&post) © 
if err == io.EOF { 
break 
} 
if err != nil { 
fmt.Println("Error decoding JSON:", err) 
return 


} 
fmt.Println(post) 


O 根据 给 定 的 JSON XIF, PE h AEM IAEI AN 


@ 遍历 JSON 文件 ， 直 到 遇见 EOF Aik 
© ISON 数据 解码 至 结构 


通过 调用 NewDecoder 并 传 入 一 个 包含 JSON 数 据 的 io ,Reader 
， 程 序 创建 出 了 一 个 新 的 解码 器 。 在 把 指向 Post 结构 的 引用 传递 给 解 
码 器 的 Decode 方法 之 后 ， 被 传 入 的 结构 就 会 填充 上 相应 的 数据 ， 然 后 
这 些 数据 就 可 以 为 程序 所 用 了 “。 当 所 有 JSON 数 据 都 被 解码 完毕 时 ， 
Decode 方法 将 会 返回 一 个 EOF ， 而 程序 则 会 在 检测 到 这 个 EOF 之 后 
退出 for 循环 。 


我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 解 码 器 


WAR TIER, Heal PAR: 


{1 Hello World! {2 Sau Sheong} [{1 Have a great day! Adam} {2 How 
are you today? Betty}]} 


最 后 ， 在 面 对 JSON 数 据 时 ， 我 们 可 以 根据 输入 决定 使 用 Decoder 
还 是 Unmarshal : 如 果 JSON 数 据 来 源 于 io .Reader 流 ， 如 
http.Request 的 Body ， 那 么 使 用 Decoder EF; 如 果 JSON 数 据 
来 源 于 字符 串 或 者 内 存 的 某 个 地 方 ， 那 么 使 用 Unmarshal 更 好 。 


7.5.2 ”创建 JSON 


正如 上 一 个 小 节 所 示 ， 分 析 JSON 的 方法 和 分 析 XML 的 方法 是 非常 
相似 的 。 同 样 地 ， 如 图 7-9 所 示 ， 创 建 JSON 的 方法 和 创建 XML 的 方法 
也 是 相似 的 。 


图 7-9 ”使 用 Go 创建 JSON: 创建 结构 并 将 其 封装 为 JSON 数 据 
代码 清单 7-12 展 示 了 把 Go 结构 封装 为 JSJON 数 据 的 具体 代码 。 


代码 清单 7-12 ”将 结构 封装 为 JSON 


package main 


import ( 
"encoding/json" 
"Fmt " 
"io/ioutil" 
) 
type Post struct { @ 
Id int json:"id". 
Content string ‘json:"content". 
Author Author ‘json:"author". 
Comments []Comment ~json:"comments"~ 
} 
type Author struct { 
Id int ~json:"id"~ 
Name string ~json:"name"~ 
} 
type Comment struct { 
Id int json:"id". 


Content string `json:"content"` 
Author string ~json:"author"~ 


} 


func main() { 
post := Post{ 
Id: 1, 
Content: "Hello World!", 
Author: Author{ 
Id: 2; 
Name: "Sau Sheong", 


ty 
Comments: []Comment{ 
Comment { 
Id: 3, 
Content: "Have a great day!", 
Author: "Adam", 
ty 
Comment { 
Id: 4, 
Content: "How are you today?", 
Author: "Betty", 
ty 
ty 


} 


output, err := json.MarshalIndent(&post, "", "\t\t") © 
if err != nil { 
fmt.Printin("Error marshalling to JSON:", err) 


return 
} 
err = ioutil.WriteFile("post.json", output, 0644) 
if err != nil { 
fmt.Println("Error writing JSON to file:", err) 
return 
} 


} 


@ 创建 结构 并 向 里 面 填充 数据 


@ 把 结构 封 疼 为 由 字 区 切片 组 成 的 JSON 数据 


跟 处 理 XML 时 的 情况 一 样 ， 这 个 封装 程序 使 用 的 结构 和 之 前 分 析 
JSON 时 使 用 的 结构 是 相同 的 。 程 序 首先 会 创建 一 些 结构 ， 然 后 通过 育 


用 MarshalIndent 函数 将 结构 封装 为 由 字 节 切片 组 成 的 JSON 数 据 
(json 库 的 MarshalIndent 函数 和 xml 库 的 MarshalIndent 函数 
的 作用 是 类 似 的 ) 。 最 后 ， 程 序 会 将 封装 所 得 的 JSON 数 据 存储 到 指定 
的 文件 中 。 


正如 我 们 可 以 通过 编码 器 手动 创建 XML 一 样 ， 我 们 也 可 以 通过 编 
句 手 动 将 Go 结构 编码 为 JSON 数 据 ， 图 7-10 展 示 了 这 个 过 程 。 


创建 出 用 于 存储 通过 编码 器 把 
创建 结构 并 创建 出 用 于 编码 
JSON 数 据 的 结构 编码 至 
向 里 面 填充 数据 oo JSON 数 据 的 编码 器 OR 


图 7-10 ”使 用 Go 创建 JSJON 数 据 : 通过 编码 器 把 结构 编码 为 JSON 


代码 清单 7-13 展 示 了 json. go 文件 中 包含 的 代码 ， 这 些 代码 可 以 
根据 给 定 的 Go 结构 创建 相应 的 JSON 文 件 。 


代码 清单 7-13 ”使 用 Encoder 把 结构 编码 为 JSON 


package main 


import ( 
"encoding/json" 
"Fmt " 
"jo" 
"os " 


) 


type Post struct { @ 


Id int json:"id". 
Content string json:"content". 
Author Author json:"author". 


Comments []Comment “json:"comments". 


type Author struct { 
Id int ”json:"id"” 


Name string ~json:"name"~ 


} 


type Comment struct { 
Id int “json: "id"~ 
Content string ~json:"content"~ 
Author string ~json:"author"~ 


} 


func main() { 


post := Post{ 
Id: 1 
Content: "Hello World!", 
Author: Author{ 
Id: 2, 
Name: "Sau Sheong", 
}, 
Comments: []Comment{ 
Comment { 
Id: 3, 
Content: "Have a great day!", 
Author: "Adam", 
}, 
Comment{ 
Id: 4, 
Content: "How are you today?", 
Author: "Betty", 


ty 
ty 
ty 
jsonFile, err := os.Create("post.json") @ 
if err != nil { 
fmt.Printlin("Error creating JSON file:", err) 
return 
} 
encoder := json.NewEncoder(jsonFile) © 


err = encoder .Encode(&post ) 
if err != nil { (4) 
fmt.Println("Error encoding JSON to file:", err) 
return 


} 
} 


@ 创建 结构 并 向 里 面 填充 数据 


@ 创建 用 于 存储 数据 的 JSON 文件 
© 根据 给 定 的 JSON 文 件 创建 出 相应 的 编码 絮 
@ 把 结构 编码 到 JSON 文 件 里 面 


跟 之 前 一 样 ， 程 序 会 创建 一 个 用 于 存储 JSON 数 据 的 JSON 文 件 ， 并 
通过 把 这 个 文件 传递 给 NewEncoder 函数 来 创建 一 个 编码 器 。 接 着 ， 
程序 会 调用 编码 器 的 Encode 方法 ， 并 向 其 传递 一 个 指向 Post 结构 的 
引用 。 在 此 之 后 ，Encode 方法 会 从 结构 里 面 提取 数据 并 将 其 编码 为 
JSON 数 据 ， 人 然后 把 这 些 JSON 数 据 写 入 创建 编码 颖 时 给 定 的 JSON 文 件 
里 面 。 


天 于 分 析 和 创建 XML 和 JSON 的 介绍 到 这 里 就 结束 了 。 虽 然 最 近 这 
两 节 介 绍 的 内 容 可 能 会 因为 模式 相似 而 显得 有 些 乏 味 ， 但 这 些 基础 知 
识 对 于 接 下 来 的 一 节 学 习 如 何 创建 Go Web 服 务 是 不 可 或 缺 的 ， 因 此 花 
时 间 学 习 和 掌握 这 些 知 识 是 非常 值得 的 。 


7.6 创建 Go Web 服 务 


创建 Go Web 服 务 并 不 是 一 件 困难 的 事情 : 如 果 你 仔细 地 阅读 并 理 
解 了 前 面 各 个 章节 介绍 的 内 容 ， 那 么 掌握 接 下 来 要 介绍 的 知识 对 你 来 
说 应 该 是 轻而易举 的 。 

本 节 将 要 构建 一 个 简单 的 基于 REST 的 Web 服 务 ， 它 允许 我 们 对 论 


坛 帖 子 执行 创建 、 获 取 、 更 新 以 及 删除 操作 。 具 体 来 说 ， 我 们 将 会 使 
用 第 6 章 介 绍 过 的 CRUD 函 数 来 包 吐 起 一 个 Web 服 务 接 口 ， 并 通过 JSON 


格式 来 传输 数据 。 除 了 本 章 之 外 ， 后 续 的 章节 也 会 治 用 这 个 Web 服 务 作 
为 例子 ， 对 其 他 概念 进行 介绍 。 


代码 清单 7-14 展 示 了 实现 Web 服 务 需要 用 到 的 数据 库 操 作 ， 这 些 操 
作 和 6.4 市 介绍 过 的 操作 基本 相同 ， 只 是 做 了 一 些 简化 。 这 些 代码 定义 
了 Web 服 务 需 要 对 数据 库 执行 的 所 有 操作 ， 它 们 都 隶属 于 main 包 ， 并 
且 被 放置 到 了 data,go 文 件 中 。 


代码 清单 7-14 使 用 data. go 访问 数据 库 


package main 


import ( 

"database/sql" 

_ "github.com/1ib/pq" 
) 


var Db *sql.DB 


func init() { © 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
sslmode= 
disable") 
if err != nil { 
panic(err) 
} 
} 


func retrieve(id int) (post Post, err error) { © 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id 


return 
} 
func (post *Post) create() (err error) { © 

statement := "insert into posts (content, author) values ($1, $2) 
returning 


id" 


stmt, err := Db.Prepare(statement ) 
if err != nil { 
return 


} 

defer stmt.Close() 

err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


} 


func (post *Post) update() (err error) { © 

_, err = Db.Exec("update posts set content = $2, author = $3 
where id = 

$1", post.Id, post.Content, post.Author) 

return 


func (post *Post) delete() (err error) 人 © 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 


@ 连接 到 数据 库 


@ 获取 指定 的 帖子 
© 创建 一 篇 新 帖子 
O 更 新 指定 的 帖子 
© 删除 指定 的 帖子 


正如 所 见 ， 这 些 代 码 跟 前 面 代 码 清单 6-6 展 示 过 的 代码 非常 相似 ， 
只 是 在 函数 名 和 方法 名 上 稍 有 区 别 ， 因 此 我 们 在 这 里 丈 不 再 一 一 解释 
。 如 有 果 你 需要 重 温 一 下 这 些 代码 的 作用 ， 那 么 可 以 去 复习 一 下 6.4 


ie) 


可 
节 


在 拥有 了 对 数据 库 执 行 CRUD 操 作 的 能 力 之 后 ， 让 我 们 来 学 习 一 下 
如 何 实现 真正 的 Web 服 务 。 代 码 清单 7-15 展 示 了 整个 Web 服 务 的 实现 代 
码 ， 这 些 代码 保存 在 文件 server .go 中 。 


代码 清单 7-15 ”定义 在 server .go 文件 内 的 Go Web 服 务 


package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 


) 


type Post struct { 
Id int json:"id". 
Content string `json:"content"` 
Author string ~json:"author"~ 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/post/", handleRequest) 
server.ListenAndServe() 
} 


func handleRequest(w http.ResponseWriter, r *http.Request) { @ 
var err error 
switch r.Method { 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err = handleDelete(w, r) 
} 
if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 


} 


} 
func handleGet(w http.Responsewriter, r *http.Request) (err error) 
{ © 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 
w.Write(output ) 
return 


} 


func handlePost(w http.Responsewriter, r *http.Request) (err error) 
{ © 

len := r.ContentLength 

body := make([]byte, len) 

r .Body.Read( body ) 

var post Post 

json.Unmarshal(body, &post) 

err = post.create() 


if err != nil { 
return 
} 
w.WriteHeader (200) 
return 
} 
func handlePut(w http.Responsewriter, r *http.Request) (err error) 
(4) 
ee err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 


len := r.ContentLength 


body := make([]byte, len) 
r.Body.Read( body ) 
json.Unmarshal(body, &post) 
err = post.update() 
if err != nil { 

return 


w.WriteHeader (200) 


return 
} 
func handleDelete(w http.Responsewriter, r *http.Request) (err 
error) { © 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
err = post.delete() 
if err != nil { 
return 


w.WriteHeader (200) 
return 


O FRE A ani oF a RPS ALE HÆRE Ee ar Ek BL 


@ 获取 指定 的 帖子 
© 创建 新 的 帖子 

O 更 新 指定 的 帖子 
O 删除 指定 的 帖子 


这 段 代码 的 结构 非常 直观 : handleRequest 多 路 复 用 器 会 根据 
请 求 使 用 的 HTTP 方 法 ， 把 请 求 转发 给 相应 的 CRUD 处 理 器 函数 ， 这 些 
函数 都 接受 一 个 Responsewriter 和 一 个 Request 作为 参数 ， 并 返 
回 可 能 出 现 的 错误 作为 函数 的 执行 结果 ; ~handleRequest 会 检查 这 
些 函 数 的 执行 结果 ， 并 在 发 现 错误 时 通过 
StatusInternalServerError 返回 一 个 500 状 态 码 。 


接 下 来 ， 让 我 们 首先 从 帖子 的 创建 操作 开始 ， 对 Go Web 服 务 的 各 
个 部 分 进行 详细 的 解释 ，handlePost 郴 数 如 代码 清单 7-16 所 示 。 


代码 清单 7-16 ”用 于 创建 帖子 的 函数 


func handlePost(w http.Responsewriter, r *http.Request) (err error) 


len := r.ContentLength 

body := make([]byte, len) 00 

r .Body.Read( body ) 

var post Post 
json.Unmarshal(body, &post) © 

err = post.create() 0 

if err != nil { 
return 


} 
w.WriteHeader (200) 
return 


@ 读 取 请 求 主体 ， 并 将 其 存储 在 字 市 切片 中 ; @ 创 建 一 个 字 节 切片 
© 把 切片 存储 的 数据 解 封 至 Post 结构 
O 创建 数据 库 记录 


handlePost 函数 首先 会 根据 内 容 的 长 度 创建 出 一 个 字 节 切片 ， 
然后 将 请 求 主体 记录 的 JSON 字 符 串 读 取 到 字 节 切片 里 面 。 之 后 ， 男 数 
会 声明 一 个 Post 结构 ， 并 将 字 市 切片 存储 的 内 容 解 封 到 这 个 结构 里 
面 。 这 样 一 来 ， 函 数 束 拥 有 了 一 个 填充 了 数据 的 Post 结构 ， 于 是 它 调 
用 结构 的 Create 方法 ， 把 记录 在 结构 中 的 数据 存储 到 了 数据 库 里 面 。 


为 了 调用 web 服务， 我 们 需要 用 到 第 3 章 介绍 过 的 cURL， 并 在 终端 
PT LAB a: 


curl -i -X POST -H "Content-Type: application/json" -d 
'£"content":"My first 


=post","author":"Sau Sheong"}' http://127.0.0.1:8080/post/ 


这 个 命令 首先 会 把 Content -Type 首部 设置 为 
application/json ， 然 后 通过 POST DIE, Pehk 
http://127.0.0.1/post/ 发 送 一 条 主体 为 JSON 字 符 串 的 HTTP 请 
求 。 如 采 一 切 顺 利 ， 应 该 会 看 到 以 下 结 


HTTP/1.1 200 OK 
Date: Sun, 12 Apr 2015 13:32:14 GMT 


Content-Length: 0 
Content-Type: text/plain; charset=utf-8 


ANE IR PARR Be UE RH Sch EH CE NIK PT OR IY RI AC 
生 任 何 错误 ， 却 无 法 说 明 帖 子 真 的 已 经 创建 成 功 了 。 为 了 验证 这 一 
点 ， 我 们 需要 通过 执行 以 下 SQL 查询 来 检视 一 下 数据 库 : 


psql -U gwp -d gwp -c "select * from posts;" 


Po 
如 果 帖 子 创建 成 功 了 ， 应 该 会 看 到 以 下 结 


content | author 
人 Ye eboney nS. Oia eee En 


1 | My first post | Sau Sheong 
(1 row) 


除了 handlePost WAZ Hh, Hell |AYWebH Ras Hy aE PAR Bilas EK BL 
都 会 假设 目标 帖子 的 id 已 经 包含 在 了 URL 里 面 。 比 如 说 ， 当 用 户 想 要 
获取 一 篇 帖子 时 ，Web 服 务 接收 到 的 请 求 应 该 指 癌 以 下 URL: 


/post/<id> 


而 这 个 URL 中 的 <id> 记 杂 的 就 是 帖子 的 jd ° (Sis 7-17 TEK 
数 古 如 何 通过 这 一 机 制 来 获取 帖子 的 。 


代码 清单 7-17 ”用 于 获取 帖子 的 函数 


func handleGet(w http.Responsewriter, r *http.Request) (err error) 


id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
post, err := retrieve(id) @ 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") @ 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") © 


w.Write(output ) 
return 


} 


@ 从 数据 库 里 获取 数据 ， 并 将 其 填充 到 Post 结构 中 
@ 把 Post 结构 封装 为 JSON FIFE 
© 把 JSON 数据 写 入 ResponseWriter 


handleGet 函数 首先 通过 path ,Base 函数 ， 从 URL 的 路 径 中 提 
取出 字符 串 格 式 的 帖子 id , eae es Atoi KØGE tid 
转换 成 整数 格式 ， 然 后 通过 把 这 个 id 传递 给 retrivePost 函数 来 获 
得 填充 了 帖子 数据 的 Post 结构 。 


在 此 之 后 ， 程 序 通过 json .MarshalIndent 函数 ， 把 Post 结构 
转换 成 了 JSON 格 式 的 字 贡 切片 。 最 后 ， 程 序 把 Content -Type 首部 设 
置 成 了 application/json ， 并 把 字 厄 切片 中 的 JSON 数 据 写 入 
Responsewriter ， 以 此 来 将 JSON 数 据 返 回 给 调用 者 。 


为 了 观察 handleGet 函数 是 如 何 工作 的 ， 我 们 需要 在 终端 里 面 执 
行 以 下 命令 : 


curl -i -X GET http://127.0.0.1:8080/post/1 


这 条 命令 会 向 给 定 的 URL 发 送 一 个 GET 请 求 ， 党 试 获取 id 为 1 的 
帖子 。 如 果 一 切 正常 ， 那 么 这 条 命令 应 该 会 返回 以 下 结果 : 


HTTP/1.1 200 OK 

Content-Type: application/json 
Date: Sun, 12 Apr 2015 13:32:18 GMT 
Content-Length: 69 


"iq" . 1 

sj 了 
"content": "My first post", 
"author": "Sau Sheong" 


在 更 新 帖子 的 时 候 ， 程 序 同样 需要 先 获 取 帖 子 的 数据 ， 具 体 细节 
如 代码 清单 7-18 所 示 。 


代码 清单 7-18 用 于 更 新 帖子 的 函数 


func handlePut(w http.Responsewriter, r *http.Request) (err error) 


{ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 

return 
} 

post, err := retrieve(id) 0& 
if err != nil { 

return 


} 
len := r.ContentLength 


body := make([]byte, len) 
r.Body.Read(body) @ 
json.Unmarshal(body, &post) © 
err = post.update() @ 
if err != nil { 
return 


w.WriteHeader (200) 
return 


@ 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 


@ 从 请 求 主 体 中 读 取 JSON 数据 
© 把 JSON 数据 解 封 至 Post 结构 
@ 对 数据 库 进 行 更 新 


在 更 新 帖子 时 ，handlePut 函数 首先 会 获取 指定 的 帖子 ， 然 后 再 
根据 PUT 请 求 发 送 的 信息 对 帖子 进行 更 新 。 在 获取 了 帖子 对 应 的 Post 
结构 之 后 ， 程 序 会 读 取 请 求 的 主体 ， 并 将 主体 中 的 内 容 解 封 至 Post 结 
构 ， 最 后 通过 调用 Post 结构 的 update 方法 更 新 帖子 。 


通过 在 终端 里 面 执行 以 下 命令 ， 我 们 可 以 对 之 前 创建 的 帖子 进行 
更 新 : 


curl -i -X PUT -H "Content-Type: application/json" -d 
'£{"content": "Updated 


=post","author":"Sau Sheong"}' http://127.0.0.1:8080/post/1 


需要 注意 的 是 ， 跟 使 用 POST 方法 创建 帖子 时 不 一 样 ， 这 次 我 们 需 
要 通过 URL 来 指定 被 更 新 帖子 的 ID。 如 果 一 切 正 常 ， 这 条 命令 应 该 会 
REA PAR: 


HTTP/1.1 200 OK 
Date: Sun, 12 Apr 2015 14:29:39 GMT 


Content-Length: 0 
Content-Type: text/plain; charset=utf-8 


现在 ， 我 们 可 以 通过 再 次 执行 以 人 下 SQL 得 询 来 确认 更 新 是 否 已 经 
成 功 : 


psql -U gwp -d gwp -c "select * from posts;" 


如 无 意外 ， 应 该 会 看 到 以 下 内 容 : 


1 | Updated post | Sau Sheong 
(1 row) 


代码 清单 7-19 展 示 了 Web 服 务 的 帖子 删除 操作 的 实现 代码 ， 这 些 代 
码 会 完 获 取 指 定 的 帖子 ， 然 后 通过 调用 delete 方法 来 删除 帖子 。 


代码 清单 7-19 用 于 删除 帖子 的 函数 


func handleDelete(w http.Responsewriter, r *http.Request) (err 
error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
post, err := retrieve(id) @ 
if err != nil { 
return 
} 
err = post.delete() @ 
if err != nil { 
return 


w.WriteHeader (200) 
return 


@ 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 
@ 从 数据 库 里 删除 这 个 帖子 


注意 ， 无 论 是 更 新 帖子 还 是 删除 帖子 ，Web 服 务 在 操作 执行 成 功 时 
都 会 返回 200 状 态 码 。 但 是 ， 如 果 处 理 辟 函数 在 处 理 请 求 时 出 现 了 任何 
错误 ， 那 么 该 错误 将 被 返回 至 handleRequest 多 路 复 用 器 ， 然 后 由 
多 路 复 用 恬 癌 客户 端 返回 一 个 500 状 态 码 。 


过 执行 下 面 的 cURL 调用 ， 我 们 可 以 删除 前 面 创建 的 帖子 : 


curl -i -X DELETE http://127.0.0.1:8080/post/1 


如 有 果 一 切 正 常 ， 那 么 这 个 cURL 调用 将 返回 以 下 结果 : 


HTTP/1.1 200 OK 
Date: Sun, 12 Apr 2015 14:38:59 GMT 


Content-Length: 0 
Content-Type: text/plain; charset=utf-8 


现在 ， 如 果 我 们 再 次 执行 之 前 的 SQL 查询 ， 就 会 发 现 之 前 创建 的 
帖子 已 经 不 复 存 在 了 : 


id | content | author 


7.7 小结 


。 编写 Web 服 务 是 Go 语言 目前 非常 常见 的 用 途 之 一 ， 了 解 如 何 构 建 
Web 服 务 是 一 项 非常 有 价值 的 技能 


© Web 服 务 主要 分 为 两 种 类 型 一 一 一 种 是 基于 SOAP 的 Web 服 务 ， 而 
另 一 种 则 是 基于 REST 的 Web 服 务 。 

o SOAP 是 一 种 协议 ， 它 能 够 对 定义 在 XML 中 的 结构 化 数据 进行 
交换 。 但 是 ， 因 为 SOAP 的 WSDL 报 文 有 可 能 会 变 得 非常 复 
杂 ， 所 以 基于 SOAP 的 Web 服 务 没有 基于 REST 的 Web 服 务 那 么 
流行 。 
基于 REST 的 Web 服 务 通 过 HTTP 协 议 向 外 界 公开 自己 拥有 的 资 
源 ， 并 允许 外 界 通过 HTTP 协 议 对 这 些 资源 执行 指定 的 动作 。 
。 创建 和 分 析 XML 以 及 JSON 的 步骤 都 是 相似 的 ， 用 户 要 么 根据 指定 

的 结构 去 生成 XML 或 者 JSJON， 要 么 从 指定 的 结构 里 面 提 取 数 据 到 
XML 或 者 JSON 里 面 ， 前 一 种 操作 称 为 封装 ， 而 后 一 种 操作 则 称 关 


解 封 。 


O 〇 


[1] SOAP API 的 搜集 结果 可 以 通过 访问 
www.programmableweb.com/category/all/apis?data_format=21176 查看 ， 
而 REST API 的 搜集 结果 可 以 通过 访问 


www.programmableweb.com/category/all/apis?data_format= 21190 查 看 。 


[2] 具体 化 指 的 是 将 抽象 的 概念 转换 为 实际 的 数据 模型 或 对 象 。 一 一 译 
HIE 


第 8 章 ”应 用 测试 


本 章 主要 内 容 


e Go 语言 的 testing Æ 
。 单元 测试 

。 HTTP 测 试 

。 使 用 依赖 注入 进行 测试 
。 使 用 第 三 方 测试 库 


测试 是 编程 工作 中 非常 重要 的 一 环 ， 但 很 多 人 却 忽视 了 这 一 点 ， 
又 或 者 只 是 把 测试 看 作 是 一 种 可 有 可 无 的 补充 手段 。Go 语 言 提 供 了 一 
些 基 本 的 测试 功能 ， 这 些 功能 初 看 上 去 可 能 会 显得 非常 原始 ， 但 正如 
本 章 将 要 介绍 的 那样 ， 这 些 工具 实际 上 已 经 能 够 满足 程序 员 对 自动 测 
试 的 需要 了 。 除 了 Go 语言 内 置 的 testing 包 之 外 ， 本 章 还 会 介绍 
check 和 Ginkgo 这 两 个 流行 的 Go 测试 包 ， 它 们 提供 的 功能 比 
testing 包 更 为 丰富 。 


跟前 面 章 市 介绍 过 的 Web 应 用 编程 库 一 样 ，Go 语 言 的 测试 库 也 只 
提供 了 基本 的 工具 ， 而 程序 员 要 做 的 就 是 在 这 些 工具 的 基础 上 ， 构 建 
出 能 够 满足 目 己 需求 的 测试 。 


8.1 ”Go 与 测试 


Go 的 标准 库 提 供 了 几 个 与 测试 有 关 的 库 ， 其 中 最 主要 的 是 
testing 包 ， 本 章 介绍 的 绝 大 部 分 测试 功能 都 来 源 于 这 个 包 。 
net/http/httptest 包 是 另 一 个 邱 Web 应 用 编程 有 天 的 库 ， 这 个 库 
是 基于 testing 库 实现 的 。 正 如 它 的 名 字 所 示 ，httptest 包 是 一 个 
用 于 测试 Web 应 用 的 库 。 


因为 testing 包 提 供 了 在 Go 中 实现 基本 的 自动 测试 的 能 力 ， 所 以 
本 章 会 先 介 绍 testing 包 ， 等 读者 了 解 了 testing 包 之 后 ， 再 学 习 
httptest 包 束 会 有 事半功倍 的 效果 。 


testing 包 需 要 与 go test 命令 以 及 源 代 码 中 所 有 以 _test .go 
后 组 结尾 的 测试 文件 一 同 使 用 。 尽 管 Go 并 没有 强制 要 求 ， 但 一 般 来 
说 ， 测 试 文件 的 名 字 都 会 与 被 测试 源码 文件 的 名 字 相 对 应 。 


举 个 例子 ， 对 于 源码 文件 server .go ， 我 们 可 以 创建 出 一 个 名 为 
server_test.go 的 测试 文件 ， 这 个 测试 文件 包含 我 们 想 对 
server . go 进行 的 所 有 测试 。 另 外 需要 注意 的 一 点 是 ， 被 测试 的 源码 
文件 和 测试 文件 必须 位 于 同一 个 包 之 内 。 


为 了 测试 源 代码 ， 用 户 需 要 在 测试 文件 中 创建 具有 以 下 格式 的 测 
REN, HOF Xxx 可 以 是 任意 英文 字母 以 及 数字 的 组 合 ， 但 是 首 字 符 
必须 是 大 写 的 英文 字母: 


func TestXxx 


(*testing.T) { ... } 


在 测试 函数 的 内 部 ， 用 户 可 以 使 用 Error > Fail 等 一 系列 方法 
表示 测试 失败 。 当 用 户 在 终端 里 面 执行 go test 命令 的 时 候 ， 所 有 符 
合 上 述 格 式 的 测试 函数 就 会 被 执行 。 如 果 一 个 测试 在 执行 时 没有 出 现 
任何 失败 ， 那 么 我 们 就 说 函数 通过 了 测试 。 接 下 来 ， 就 让 我 们 实际 地 
学 习 如 何 使 用 testing 包 进 行 测试 。 


8.2 ”使 用 Go 进行 单元 测试 


顾名思义 ， 单 元 测试 (unit test) ， 就 是 一 种 为 验证 单元 的 正确 性 
而 设置 的 上 自动 化 测试 ， 一 个 单元 束 是 程序 中 的 一 个 模块 化 部 分 。 一 般 
来 说 ， 一 个 单元 通常 会 与 程序 中 的 一 个 函数 或 者 一 个 方法 相对 应 ， 但 
这 并 不 是 必须 的 。 程 序 中 的 一 个 部 分 能 否 独立 地 进行 测试 ， 是 评判 这 
个 部 分 能 否 被 归纳 为 “单元 ”的 一 个 重要 指标 。 一 个 单元 通常 会 接受 数 
据 作 为 输入 并 返回 相应 的 输出 ， 而 单元 测试 用 例 要 做 的 束 是 同和 单元 传 
入 数据 ， 然 后 检查 单元 产生 的 输出 是 否 符合 预期 。 单 元 测试 通 音 会 以 
测试 套件 (test suite) 的 形式 运行 ， 后 者 是 为 了 验证 特定 行为 而 创建 的 
单元 测试 用 例 集合 。 


Go 的 单元 测试 会 按照 功能 分 组 ， 并 放置 在 以 _test .go 为 后 级 的 
文件 当中 。 作 为 例子 ， 我 们 接 下 来 要 考虑 的 是 如 何 对 代码 清单 8-1 所 示 
的 main,go 文 件 中 的 decode 函数 进行 测试 。 


代码 清单 8-1 一 个 JSON 数 据 解码 程序 


package main 


import ( 
"encoding/json" 


Nos!" 

) 

type Post struct { 
Id int “json: "id"~ 
Content string ~json: "content" 
Author Author ~json:"author"~ 


Comments []Comment ~json:"comments"~ 


type Author struct { 
Id int json:"id". 
Name string ~json:"name"~ 


} 


type Comment struct { 
Id int “json: "id" 
Content string ~json:"content"~ 
Author string ~json:"author"~ 


} 


func decode(filename string) (post Post, err error) { © 
jsonFile, err := os.Open(filename) © 
if err != nil { @ 
fmt.Println("Error opening JSON file:", err) ©@ 
return @ 
} @ 
defer jsonFile.Close() @ 


decoder := json.NewDecoder(jsonFile) @ 
err = decoder.Decode(&post) © 
if err != nil { @ 
fmt.Println("Error decoding JSON:", err) @ 


return @ 
} eo 
return @ 
} eo 
func main() { ©@ 
_, err := decode("post.json") © 
if err != nil { 
fmt.Println("Error:", err) 


} 
} 


O E TRS ACES EH Bl A A AS SANGE 


这 个 程序 复 用 了 之 前 在 代码 清单 7-8 和 代码 清单 7-9 中 展示 过 的 
JSON 解 码 程序 ， 但 是 它 并 没有 像 昌 程序 那样 把 所 有 逮 辑 都 放 到 main 
函数 里 面 ， 而 是 将 旧 程 序 中 负责 打开 文件 并 对 其 进行 解码 的 部 分 重 构 
到 了 单独 的 decode KAEH, Aa Emain KUP YA decode Kj 
数 。 需 要 注意 的 是 ， 虽 然 程 序 员 在 大 部 分 时 间 里 关注 的 都 是 如 何 编写 
代码 从 而 实现 特性 并 交付 功能 ， 但 写 出 可 测试 的 代码 同样 也 是 非常 重 
要 的 。 为 了 做 到 这 一 点 ， 程 序 员 通 常 需 要 在 编写 程序 之 前 对 程序 的 设 
计 进 行 思 考 ， 并 把 测试 看 作 是 软件 开发 的 重要 一 环 ， 本 章 稍 后 将 对 这 
一 点 进行 更 详细 的 说 明 。 


代码 清单 8-2 展 示 了 我 们 将 要 解码 的 JSON 文 件 ， 它 跟 第 7 章 中 被 解 
码 的 JSON 文 件 是 完全 一 样 的 。 


代码 清单 8-2 ”被 解码 的 post .json 文件 


{ 


"iq" . 1 
* 了 
"content" : "Hello World!", 
"author" : { 
"id" : 2, 
"name" : "Sau Sheong" 
了 
"comments" : [ 
rad!" 33y 
"content" : "Have a great day!", 
"author" : "Adam" 
ty 
{ . 
"id" : 4, 
"content" : "How are you today?", 
"author" : "Betty" 


代码 清单 8-3 展 示 了 人 负责 测试 main .go 文件 的 main_test.go 文 
件 。 


代码 清单 8-3 Wmain. go 进行 测试 的 main_test .go 文件 


package main @ 


import ( 
"testing" 
) 


func TestDecode(t *testing.T) { 
post, err := decode("post.json") @ 
if err != nil { 
t.Error(err) 


if post.Id !=1{ © 
t.Error("Wrong id, was expecting 1 but got", post.Id) 6 

} © 

if post.Content != "Hello World!" { 6 
t.Error("Wrong content, was expecting 'Hello World!' but got", 
=post.Content) 


} 


i 
func TestEncode(t *testing.T) { 
t.Skip("Skipping encoding for now") © 


@ 测试 文件 与 被 测试 的 源 代码 文件 位 于 同一 个 包 内 

@ 调用 被 测试 的 函数 

O 检查 结 来 是 否 和 预期 的 一 样 ， 如 来 不 一 样 束 显示 一 条 出 错 信 息 
O 暂时 跳 过 对 编码 函数 的 测试 


这 个 测试 文件 与 被 测试 的 源码 文件 位 于 同一 个 包 内 ， 它 唯一 导入 
并 使 用 的 包 为 testing 包 。 画 数 TestDecode 是 一 个 测试 用 例 ， 它 代 
表 的 是 对 decode 函数 的 单元 测试 。TestDecode 接受 一 个 指向 
testing. T 结构 的 指针 作为 参数 ， 该 结构 是 testing 包 中 两 个 主要 
结构 之 一 ， 当 被 测试 函数 的 输出 结果 未 如 预期 时 ， 用 户 就 可 以 使 用 这 
个 结构 来 产生 相应 的 失败 (failure) 以 及 错误 (error) ° 


testing ,T 结 构 拥 有 几 个 非常 有 用 的 画 数 : 


¢ Log 一 一 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 与 fmt .Println 
类 似 ; 

。Logf 一 一 根据 给 定 的 格式 ， 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 
与 fmt .Printf 类 似 ; 

。Fail 一 一 将 测试 函数 标记 为 “已 失败 ”， 但 允许 测试 函数 继续 执 
行 ; 

。 FailNow 一 一 将 测试 函数 标记 为 “已 失败 ?并 停止 执行 测试 函数 。 


除 以 上 4 个 画 数 之 外 ，testing.T 结构 还 提供 了 图 8-1 所 示 的 一 些 
便利 函数 (convenience function) ， 这 些 便利 函数 都 是 由 以 上 4 个 函数 
组 合 而 成 的 。 


a Bee 


图 8-1 testing.T 结构 提供 的 各 个 函数 ， 每 个 格子 都 表示 一 个 函数 ， 其 中 位 于 白色 格子 内 的 
函数 为 便利 函数 ， 它 们 由 位 于 灰色 格子 内 的 函数 组 合 而 成 。 例 如 ，Error 函数 是 Log 函数 和 
Fail 函数 的 组 合 画 数 ， 它 在 被 调用 时 ， 会 先 调用 Log 函数 ， 然 后 再 调用 Fail 函数 


| 


在 图 8-1 中 ， 组 合 函 数 Error 将 会 先后 调用 Log 函数 和 Fail K 
A, MAHEK Fatal 则 会 先后 调用 Log KM FailNow RY ° 


在 测试 函数 TestDecode 内 部 ， 程 序 会 正常 地 调用 decode K 
数 ， 然 后 对 函数 返回 的 结果 进行 检查 。 如 果 函 数 返 回 的 结果 和 预期 的 
结果 不 一 致 ， 那 么 程序 就 可 以 根据 情况 调用 Fail 、FailNow ` 
Error 、Errorf 或 者 Fatalf 等 画 数 。 正 如 之 前 所 说 ，Fail WAVE 
把 一 个 测试 用 例 标记 为 “已 失败 ”之 后 ， 会 允许 这 个 测试 用 例 继续 执 
行 ， 但 FailNow 函数 则 会 更 严格 一 些 一 一 它 在 把 一 个 测试 用 例 标记 
为 “已 失败 ”之 后 会 立即 退出 ， 不 再 执行 这 个 测试 用 例 的 剩余 代码 。 无 
论 是 Fail 还 是 FailNow ， 它 们 都 只 会 对 目 己 所 处 的 测试 用 例 产 生 影 
响 ， 比 如 ， 在 上 面 的 例子 中 ，TestDecode 调用 的 Error 函数 就 只 会 
对 TestDecode 本 身 产生 影响 。 


为 了 运行 TestDecode 测试 用 例 ， 我 们 需要 在 测试 文件 
main_test.go 所 在 的 目录 中 执行 以 下 命令 : 


这 条 命令 会 执行 当前 目录 中 名 字 以 _test .go 为 后 级 的 所 有 文 
件 。 当 我 们 在 名 为 unit_testing 的 目录 中 执行 这 个 命令 时 ， 它 将 产 
生 以 下 结果 : 


PASS 


ok unit_testing 0.004s 


可 惜 的 是 ， 这 个 结果 并 没有 给 出 多 少 有 用 的 信息 。 为 此 ， 我 们 可 
以 使 用 具体 (verbose) 标志 -v 来 获得 更 详细 的 信息 ， 并 通过 履 盖 率 标 
志 -cover 来 获知 测试 用 例 对 代码 的 覆盖 率 : 


go test -v -cover 


执行 这 条 命令 将 得 到 以 下 结 来 : 


=== RUN TestDecode 

- PASS: TestDecode (0.00s) 
=== RUN TestEncode 

- SKIP: TestEncode (0.00s) 


main_test.go:23: Skipping encoding for now 
PASS 
coverage: 46.7% of statements 
ok unit_testing 0.004s 


8.2.1 ” 跳 过 测试 用 例 


代码 清单 8-3 在 同一 个 测试 文件 里 包含 了 两 个 测试 用 例 ， 第 一 个 是 
前 面 已 经 介绍 过 的 TestDecode ， 而 另 一 个 则 是 TestEncode 。 因 为 
代码 清单 8-1 中 的 程序 并 未 实现 相应 的 编码 方法 ， 所 以 TestEncode 并 
没有 做 任何 实际 的 行为 。 程 序 员 在 进行 测试 驱动 开发 (test-driven 
development, TDD) 的 时 候 ， 通 常会 让 测试 用 例 持续 地 失败 ， 直 到 函数 
被 真正 地 实现 出 来 为 止 ， 但 是 ， 为 了 避免 测试 用 例 在 函数 尚未 实现 之 
前 一 直 打印 烦人 的 失败 信息 ， 用 户 也 可 以 使 用 testing,T 结构 提供 的 


Skip 函数 ， 和 暂时 跳 过 指定 的 测 斌 用例。 此外， 如果 某 个 测试 用 例 的 执 
行 时 间 非 党 长 ， 我 们 也 可 以 在 实施 完整 性 检查 (sanity check) 的 时 
候 ， 使 用 Skip 函数 跳 过 该 测试 用 例 。 


除了 可 以 直接 跳 过 整个 测 斌 用例， 用户 还 可 以 通过 网 go test 命 
令 传 入 短暂 标志 -short ， 并 在 测试 用 例 中 使 用 某 些 条 件 逻 辑 来 跳 过 测 
试 中 的 指定 部 分 。 注 意 ， 这 种 做 法 跟 在 go test 命令 中 通过 选项 来 选 
择 性 地 执行 指定 的 测试 不 一 样 : 选择 性 执行 只 会 执行 指定 的 测试 ， 并 
跳 过 其 他 所 有 测试 ， 而 -short 标志 则 会 根据 用 户 编 写 测试 代码 的 方 
式 ， 跳 过 测试 中 的 指定 部 分 或 者 跳 过 整个 测试 用 例 。 


作为 例子 ， 让 我 们 来 看 一 下 如 何 通 过 -short 标志 来 避免 执行 一 个 
长 时 间 运 行 的 测试 用 例 。 首 先 ， 在 main_test .go 文件 中 导入 time 
包 ， 并 创建 一 个 新 的 测试 用 例 : 
func TestLongRunningTest(t *testing.T) { 


if testing.Short() { 
t.Skip("Skipping long-running test in short mode") 


time.Sleep(10 * time.Second) 


如 果 用 户 给 定 了 -short 标志 ， 测 试用 例 
TestLongRunningTest 将 被 跳 过 ; 相反 ， 如 果 用 户 没有 给 定 - 
short 标志 ， 那 么 TestLongRunningTest 用 例 将 被 执行 ， 并 因此 
导致 测试 过 程 休 眼 10 s。 现 在 ， 首 先 让 我 们 来 看 一 下 测试 用 例 在 一 般 情 
况 下 是 如 何 运行 的 : 


=== RUN TestDecode 

--- PASS: TestDecode (0.00s) 

=== RUN TestEncode 

--- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 


=== RUN TestLongRunningTest 

--- PASS: TestLongRunningTest (10.00s) 
PASS 

coverage: 46.7% of statements 

ok unit_testing 10.004s 


正如 我 们 所 料 ， 测 试 花 了 10 s 来 执行 TestLongRunningTest 测 
试用 例 。 现 在， 我 们 使 用 以 下 命令 再 次 运行 测试 : 


go test -v -cover -short 


这 次 运行 测试 将 得 出 以 下 结 


=== RUN TestDecode 

--- PASS: TestDecode (0.00s) 

=== RUN TestEncode 

--- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 

=== RUN TestLongRunningTest 


--- SKIP: TestLongRunningTest (0.00s) 
main_test.go:29: Skipping long-running test in short mode 
PASS 
coverage: 46.7% of statements 
ok unit_testing 0.004s 


正如 结果 所 示 ， 长 时 间 运 行 的 测试 用 例 TestLongRunningTest 
在 这 次 测试 中 被 跳 过 了 。 


8.2.2 ”以 并 行 方式 运行 测试 


正如 之 前 所 说 ， 单 元 测试 的 目的 是 独立 地 进行 测试 。 尽 管 有 些 时 
候 ， 测 试 套件 会 因为 内 部 存在 依赖 关系 而 无 法 独立 地 进行 单元 测试 ， 
但 是 只 要 单元 测试 可 以 独立 地 进行 ， 用 户 就 可 以 通过 并 行 地 运行 测试 


用 例 来 提升 测试 的 速度 了 ， 本 节 的 内 容 将 回 我 们 展示 如 何在 Go 中 实现 
Xe 


首先 ， 在 main_test .go 文件 所 在 的 目录 中 创建 一 个 名 为 
parallel_test.go 的 文件 ， 并 在 文件 中 键入 代码 清单 8-4 所 示 的 代 
jg o 


代码 清单 8-4 ”并行 测 试 


package main 


import ( 
"testing" 
"time" 


) 


func TestParallel_i(t *testing.T) { © 
t.Parallel() @ 
time.Sleep(1 * time.Second) 


func TestParallel_2(t *testing.T) { ® 
t.Parallel() 
time.Sleep(2 * time.Second) 


func TestParallel_3(t *testing.T) { © 
t.Parallel() 
time.Sleep(3 * time.Second) 


@ 模拟 需要 耗 时 一 秒 钟 运行 的 任务 


@ 调用 Parallel 函数 ， 以 并 行 方式 运行 测试 用 例 

© 模拟 需要 耗 时 2 秒 运行 的 任务 

O 模拟 需要 耗 时 3 秒 运行 的 任务 

这 个 程序 利用 time ,Sleep 函数 ， 以 3 个 测试 用 例 分 别 模拟 了 3 个 
需要 耗 时 1s、2s 和 3s 来 运行 的 任务 ， 并 且 为 了 让 这 些 测试 用 例 能 够 以 并 
行 的 方式 运行 ， 程 序 还 在 每 个 测试 用 例 的 开头 调用 了 testing,T 结构 
的 Parallel 函数 。 


现在 ， 我 们 只 要 在 终端 中 执行 以 下 命令 ，Go 融 会 以 并 行 的 方式 运 
行 测 试 : 


go test -v -short -parallel 3 


这 条 命令 中 的 并 行 标志 -parallel 用 于 指示 Go 以 并 行 方式 运行 测 
斌 用例， 而 参数 3 则 表示 我 们 希望 最 多 并 行 运行 3 个 测试 用 例 。 男 外 ， 
这 条 命令 还 使 用 了 -short 标志 ， 以 便 跳 过 main_test .go 测试 文件 
中 需要 长 时 间 运 行 的 测试 用 例 。 以 下 是 这 个 命令 的 执行 结果 : 


=== RUN TestDecode 
- PASS: TestDecode (0.00s) 
=== RUN TestEncode 
- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 
=== RUN TestLongRunningTest 
- SKIP: TestLongRunningTest (0.00s) 
main_test.go:30: Skipping long-running test in short mode 
=== RUN TestParallel_1 
=== RUN TestParallel_2 
=== RUN TestParallel_3 


- PASS: TestParallel_1 (1.00s) 
- PASS: TestParallel_2 (2.00s) 
- PASS: TestParallel_3 (3.00s) 
PASS 
ok unit_testing 3.006s 


从 这 个 结果 我 们 可 以 看 到 ，main_test ,go 文件 和 
parallel_test .go 文件 中 的 所 有 测试 用 例 都 被 执行 了 ， 更 为 重要 的 
是 ，parallel_test .go 文件 中 的 3 个 并 行 测 试用 例 被 同时 执行 了 : 
尽管 这 3 个 并 行 测试 用 例 的 运行 时 长 各 有 不 同 ， 但 由 于 它们 是 同时 运行 
的 ， 所 以 这 3 个 测试 用 例 最 终 都 在 运行 时 长 最 长 的 测试 用 例 
TestParallel_3 的 执行 过 程 中 结束 了 ， 这 也 是 整个 测试 最 终 耗 费 了 
3.006 s 的 原因 一 一 其 中 0.006 s 用 于 执行 hain_test .go 中 的 前 几 个 测 
斌 用例， 而 3 s 则 用 于 执行 parallel_test ,go 中 运行 时 间 最 长 的 测 
试用 例 TestParallel 3。 


8.2.3 ”基准 测试 


Go 的 testing 包 文 持 两 种 类 型 的 测试 ， 一 种 是 用 于 检验 程序 功能 
性 的 功能 测试 (functional testing) ， 而 另 一 种 则 是 用 于 查 明 任 务 单 元 
性 能 的 基准 测试 (benchmarking) 。 在 上 一 节 学 习 过 如 何 进 行 功能 测试 
之 后 ， 这 一 节 我 们 将 要 学 习 如 何 进 行 基准 测试 。 


跟 单 元 测试 一 样 ， 基 准 测试 用 例 也 需要 放置 到 以 _test .go 为 后 
缀 的 文件 中 ， 并 且 每 个 基准 测试 画 数 都 需要 符合 以 下 格式 : 


func BenchmarkXxx(*testing.B) { ... } 


作为 例子 ， 代 码 清单 8-5 展示 了 一 个 基准 测试 用 例 函 数 ， 这 个 函数 
定义 在 文件 bench_test .go 里 面 。 


代码 清单 8-5 ”基准 测试 


package main 


import ( 
"testing" 


// benchmarking the decode function 
func BenchmarkDecode(b *testing.B) { 
for i := 0; i < b.N; i++ { ©@ 
decode("post.json") 


O 循环 执行 解码 函数 ， 以 便 对 其 进行 b.N 次 基准 测试 


正如 代码 所 示 ， 在 Go 语言 中 进行 基准 测试 是 非常 直观 的 ， 测 试 程 
序 要 做 的 就 是 将 被 测试 的 代码 执行 b ,N 次 ， 以 便 准确 地 检测 出 代码 的 
响应 时 间 ， 其 中 b.N 的 值 将 根据 被 执行 的 代码 而 改变 。 比 如 ， 存 上 面 
展示 的 基准 测试 例子 中 ， 测 试 程序 就 将 decode 画 数 执行 了 b.N 次 。 

为 了 运行 基准 测试 用 例 ， 用 户 需要 在 执行 go test 命令 时 使 用 基 
准 测试 标志 -bench ， 并 将 一 个 正则 表达 式 用 作 该 标志 的 参数 ， 从 而 标 
识 出 自己 想 要 运行 的 基准 测试 文件 。 当 我 们 需要 运行 目录 下 的 所 有 基 
准 测试 文件 时 ， 只 需要 把 点 (.) 用 作 -bench 标志 的 参数 即 可 ， 


go test -v -cover -Short -bench . 


下 面 是 这 条 命令 的 执行 结果 : 


=== RUN TestDecode 

- PASS: TestDecode (0.00s) 
=== RUN TestEncode 

- SKIP: TestEncode (0.00s) 
main_test.go:38: Skipping encoding for now 
=== RUN TestLongRunningTest 

- SKIP: TestLongRunningTest (0.00s) 


main_test.go:44: Skipping long-running test in short mode 
PASS 

BenchmarkDecode 100000 19480 ns/op 

coverage: 42.4% of statements 

ok unit_testing 2.243s 


结果 中 的 100000 为 测试 时 b .N 的 实际 值 ， 也 就 是 函数 被 循环 执 
行 的 次 数 。 在 这 个 例子 中 ， 和 迭代 进行 了 10 万 次 ， 并 且 每 次 耗费 了 19480 
ns， 即 0.01948 ms。 和 需要 注意 的 是 ， 在 进行 基准 测试 时 ， 测 试用 例 的 迭 
代 次 数 是 由 Go 上 自行 决定 的 ， 虽 然 用 户 可 以 通过 限制 基准 测试 的 运行 时 
间 达 到 限制 迭代 次 数 的 目的 ， 但 用 户 是 无 法 直接 指定 迭代 次 数 的 一 一 
测试 程序 将 进行 足够 多 次 的 迭代 ， 直 到 获得 一 个 准确 的 测量 值 为 上 。 
在 Go 1.5 中 ，test 子 命 令 拥有 一 个 -test .count 标志 ， 它 可 以 让 用 
户 指定 每 个 测试 以 及 基准 测试 的 运行 次 数 ， 该 标志 的 默认 值 为 1 。 


注意 ， 上 面 的 命令 既 运行 了 基准 测试 ， 也 运行 了 功能 测试 。 如 果 
需要 ， 用 户 也 可 以 通过 运行 标志 -run 来 忽略 功能 测试 。-run 标志 用 
于 指定 需要 被 执行 的 功能 测试 用 例 ， 如 采用 户 把 一 个 不 存在 的 功能 测 
试 名 字 用 作 -run 标志 的 参数 ， 那 么 所 有 功能 测试 都 将 被 忽略 。 比 如 ， 
如 果 我 们 执行 以 下 命令 : 


go test -run x -bench . 


那么 由 于 我 们 的 测试 中 不 存在 任何 名 字 为 x 的 功能 测试 用 例 ， 因 此 
所 有 功能 测试 部 不 会 彼 运 行 。 在 只 执行 基准 测试 的 情况 下 ，go test 
命令 将 产生 以 下 结 


PASS 
BenchmarkDecode 100000 19714 ns/op 


ok unit_testing 2.150s 


虽然 检测 单个 函数 的 运行 速度 非常 有 用 ， 但 如 有 果 我 们 能 够 对 比 两 
个 函数 的 运行 速度 ， 那 么 事情 无 疑 会 变 得 更 加 有 意义 ! 回想 一 下 ， 我 
们 在 第 7 章 曾经 学 过 如 何 用 两 种 不 同 的 方法 把 JSON 数 据 解 封 为 结构 : 
一 种 是 使 用 Decode 函数 ， 另 一 种 则 是 使 用 Unmarshal 函数 。 因 为 上 
面 的 基准 测试 已 经 检测 出 了 Decode 函数 的 运行 速度 ， 那 么 接 下 来 就 让 
我 们 检测 一 下 Unmarshal 函数 的 运行 速度 吧 。 但 是 在 进行 基准 测试 之 
前 ， 我 们 需要 像 代码 清单 8-6 展 示 的 那样 ， 将 解 封 操 作 的 代码 重 构 到 
main.go 文 件 的 unmarshal KP ° 


I 


代码 清单 8-6 ” 解 封 ISON 数 据 的 函数 


func unmarshal(filename string) (post Post, err error) { 
jsonFile, err := os.0pen(filename) 
if err != nil { 
fmt.Println("Error opening JSON file:", err) 
return 


defer jsonFile.Close() 


jsonData, err := ioutil.ReadAll(jsonFile) 

if err != nil { 
fmt.Printin("Error reading JSON data:", err) 
return 


} 


json.Unmarshal(jsonData, &post) 
return 


之 后 ， 我 们 还 需要 在 基准 测试 文件 bench_test ,go 中 添加 代码 
清单 8-7 所 示 的 基准 测试 用 例 ， 以 便 对 u nmarshal 函 数 进行 基准 测试 。 


代码 清单 8-7 ”对 unmarshal 函 数 进 行 基准 测试 


func BenchmarkUnmarshal(b *testing.B) { 
for i := 0; i < b.N; i++ { 
unmarshal("post.json") 


一 切 准备 就 绪 之 后 ， 再 次 运行 基准 测 斌 命令， 我们 将 得 到 以 下 结 
R: 


PASS 
BenchmarkDecode 100000 19577 ns/op 


BenchmarkUnmarshal 50000 24532 ns/op 
ok unit_testing 3.628s 


从 上 述 结果 可 以 看 到 ，Decode 函数 每 次 执行 需要 耗费 0.019577 
ms， 而 Unmarshal 函数 每 次 执行 需要 耗费 0.024532 ms， 这 说 明 
Unmar shal 函数 比 Decode 函数 慢 了 大 约 25%。 


8.3 ”使 用 Go 进行 HTTP 测 试 


因为 这 是 一 本 关于 Web 编 程 的 书 ， 所 以 我 们 除了 要 学 习 如 何 测试 普 
通 的 Go 程序 ， 还 需要 学 习 如 何 测试 Go Web 应 用 。 测 试 Go Web 应 用 的 方 
法 有 很 多 ， 但 是 在 这 一 市 中 ， 我 们 只 考虑 如 何 使 用 Go 对 Web 应 用 的 处 
理 需 进行 单元 测试 。 


对 Go Web 应 用 的 单元 测试 可 以 通过 testing/httptest 包 来 完 
成 。 这 个 包 提供 了 模拟 一 个 Web 服 务 器 所 需 的 设施 ， 用 户 可 以 利用 
net/http 包 中 的 客户 端 函 数 向 这 个 服务 器 发 送 HITP 请 求 ， 然 后 获取 
模拟 服务 器 返回 的 HTTP 啊 应 。 


为 了 演示 httptest 包 的 使 用 方法 ， 我 们 会 复 用 之 前 在 7.14 世 展示 
过 的 简单 Web 服 务 。 正 如 之 前 所 说 ， 这 个 简单 Web 服 务 只 拥有 一 个 名 为 
handleRequest 的 处 理 颖 ， 它 会 根据 请 求 使 用 的 HTTP 方 法 ， 将 请 求 
多 路 复 用 到 相应 的 处 理 硕 函数 。 举 个 例 季 ， 如 采 handleReduest 接 
收 到 的 是 一 个 HITP GET 请 求 ， 那 么 它 会 把 该 请 求 多 路 复 用 到 
handleGet 函数 ， 代 码 清单 8-8 展 示 了 这 两 个 函数 的 具体 定义 。 


代码 清单 8-8 ”负责 多 路 复 用 请 求 的 处 理 器 以 及 负责 处 理 请 求 的 6ET 处 理 器 函数 


func handleRequest(w http.ResponsewWriter, r *http.Request) { © 
var err error 
switch r.Method { @ 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err = handleDelete(w, r) 


if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 


return 


} 


func handleGet(w http.Responsewriter, r *http.Request) (err error) 


{ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 
} 


w.Header().Set("Content-Type", "application/json") 
w.Write(output ) 
return 


@ handleRequest 将 根据 请 求 使 用 的 HITP 方法 对 其 进行 多 路 复 用 


O 根据 请 求 使 用 的 HTTP 方法 ， 调 用 相应 的 处 理 右 函数 


代码 清单 8-9 展 示 了 一 个 通过 HTTP GET 请 求 对 简单 Web 服 务 进行 
单元 测试 的 例子 ， 而 图 8- 了 这 个 程序 的 整个 执行 过 程 。 


代码 清单 8-9 ”使 用 GET 请 求 进行 测试 


package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 


) 


func TestHandleGet(t *testing.T) { 


mux := http.NewServeMux() © 
mux.HandleFunc("/post/", handleRequest) @ 


writer := httptest.NewRecorder() © 
request, _ := http.NewRequest("GET", "/post/i", nil) © 
mux.ServeHTTP(writer, request) © 


if writer.Code != 200 { © 

t.Errorf("Response code is %v", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 

t.Error("Cannot retrieve JSON post") 


@ 创建 一 个 用 于 运行 测试 的 多 路 复 用 如 


@ 绑 定 想 要 测试 的 处 理 器 

© 创建 记录 器 ， 用 于 获取 服务 器 返回 的 HTTP 响应 
@ 为 被 测试 的 处 理 器 创建 相应 的 请 求 

© 向 被 测试 的 处 理 器 发 送 请 求 

@ 对 记录 器 记载 的 响应 结果 进行 检查 


因为 每 个 测试 用 例 都 会 独立 运行 并 启动 各 自 独 有 的 用 于 测试 的 Web 
服务 器 ， 所 以 程序 需要 创建 一 个 多 路 复 用 器 并 将 handleRequest 处 
理 器 与 其 进行 绑 定 。 除 此 之 外 ， 为 了 获取 服务 器 返回 的 HTTPH 啊 应 ， 程 
序 使 用 httptest .New Recorder 函 数 创建 了 一 个 ResponseRecorder 
结构 ， 这 个 结构 可 以 把 响应 存储 起 来 以 便 进 行 后 续 的 检查 。 


与 此 同时 ， 程 序 还 需要 调用 http ,NewRequest 函数 ， 并 将 请 求 
使 用 的 HTTP 方 法 、 被 请 求 的 URL 以 及 可 选 的 HTTP 请 求 主 体 传 递 给 该 
函数 ， 从 而 创建 一 个 HTTP 请 求 〈 在 第 3 章 和 第 4 章 ， 我 们 讨论 的 是 如 何 
分 析 一 个 HTTP 请 求 ， 而 创建 HTTP 请 求 正好 就 是 分 析 HTTP 请 求 的 逆 操 
VE) ° 


对 记录 器 记载 的 响应 结果 进行 检查 


= 


图 8-2 使 用 Go 的 httptest 包 进 行 HTTP 测 试 的 具体 步 又 


程序 在 创建 出 相应 的 记录 器 以 及 HTTP 请 求 之 后 ， 就 会 使 用 
ServeHTTP 把 它们 传递 给 多 路 复 用 右 。 多 路 复 用 硕 handleRequest 


在 接收 到 请 求 之 后 ， 残 会 把 请 求 转发 给 handleGet 函数 ， 然 后 由 
handleGet 函数 对 请 求 进行 处 理 ， 并 最 终 返 回 一 个 HTTP 啊 应 。 跟 一 
般 服 务 器 不 同 的 是 ， 模 拟 服务 器 的 多 路 复 用 器 不 会 把 处 理 器 返回 的 啊 
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序 可 以 在 之 后 对 响应 的 结果 进行 验证 。 测 试 程序 最 后 的 几 行 代码 非常 
容易 看 屏 ， 它 们 要 做 的 束 是 对 啊 应 进行 检查 ， 看 看 处 理 右 返回 的 结 来 
是否 跟 预 期 的 一 样 ， 并 在 出 现 意 料 之 外 的 结果 时 ， 像 普通 的 单元 测试 
那样 抛 出 一 个 错误 。 


因为 这 些 操 作 看 上 去 都 非常 商 单 ， 所 以 不 妨 让 我 们 再 来 看 另 一 个 
例子 一 一 代码 清单 8-10 展 示 了 如 何 为 PUT 请 求 创建 一 个 测试 用 例 。 


代码 清单 8-10 ”对 PUT 请 求 进 行 测试 


func TestHandlePut(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest ) 


writer := httptest.NewRecorder( ) 

json := strings.NewReader(°{"content": "Updated 
post", "author":"Sau 

Sheong") ) 


request, _ := http.NewRequest("PUT", "/post/i", json) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 
} 


正如 代码 所 示 ， 这 次 的 测试 用 例 除 了 需要 向 请 求 传 入 JSON 数 据 ， 
跟 之 前 展示 的 测试 用 例 并 没有 什么 特别 大 的 不 同 。 除 此 之 外 你 可 能 会 
注意 到 ， 上 述 两 个 测试 用 例 出 现 了 一 些 完全 相同 的 代码 。 为 了 保持 代 


码 的 简洁 性 ， 我 们 可 以 把 一 些 重 复出 现 的 测试 代码 以 及 其 他 测试 夹具 
(fixture) 代码 放置 到 一 个 预 设 函 数 (setup function) 里 面 ， 然 后 在 运 
行 测试 之 前 执行 这 个 函数 。 


Go 的 testing 包 人 允许 用 户 通过 TestMain 函数 ， 在 进行 测试 时 执 
行 相应 的 预 设 (setup) 操作 或 者 拆卸 (teardown) 操作 。 一 个 典型 的 
TestMain 函数 看 上 去 是 下 面 这 个 样子 的 ; 


func TestMain(m *testing.M) { 
setUp() 
code := m.Run() 
tearDown( ) 


os.Exit(code) 


setUp 函数 和 tearDown 函数 分 别 定 义 了 测试 在 预 设 阶段 以 及 拆 
卸 阶 段 需要 执行 的 工作 。 需 要 注意 的 是 ，setuUp 函数 和 tearDown Kl 
数 是 为 所 有 测试 用 例 设 置 的 ， 它 们 在 整个 测试 过 程 中 只 会 被 执行 一 
次 ， 其 中 setUp 函数 会 在 所 有 测试 用 例 被 执行 之 前 执行 ， 而 
tearDown 函数 则 会 在 所 有 测试 用 例 都 被 执行 完毕 之 后 执行 。 至 于 测 
试 程序 中 的 各 个 测试 用 例 ， 则 由 testing.M 结构 的 Run 方法 负责 调 
~ 该 方法 在 执行 之 后 将 返回 一 个 退出 码 (exit code) ， 用 户 可 以 把 这 

退出 码 传递 给 os .Exit 函数 。 


代码 清单 8-11 展 示 了 测试 程序 使 用 TestMain 函数 之 后 的 样子 。 


代码 清单 8-11 使 用 httptest 包 的 TestMain HA 


package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
Nos! 
"strings" 
"testing" 


) 


var mux *http.ServeMux 
var writer *httptest.ResponseRecorder 


func TestMain(m *testing.M) { 
setUp() 
code := m.Run() 
os.Exit(code) 


} 


func setUp() { 
mux = http.NewServeMux( ) 
mux.HandleFunc("/post/", handleRequest ) 
writer = httptest.NewRecorder() 


} 


func TestHandleGet(t *testing.T) { 
request, _ := http.NewRequest("GET", "/post/1i", 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 

t.Errorf("Cannot retrieve JSON post") 


} 
} 
func TestHandlePut(t *testing.T) { 

json := strings.NewReader(°{"content": "Updated 
post", "author":"Sau 

Sheong") ) 

request, _ := http.NewRequest("PUT", "/post/1i", 


mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 


nil) 


json) 


Po 
更 新 后 的 测试 程序 把 每 个 测试 用 例 都 会 用 到 的 全 局 变量 放 到 了 
setup KF, SEMA IGEN UKE EM RR, mm EH 
把 所 有 与 测试 用 例 有 关 的 预 设 操作 都 集中 到 了 一 起 。 但 是 ， 因 为 这 个 
程序 在 测试 之 后 不 需要 进行 任何 收尾 工作 ， 所 以 它 没有 配置 相应 的 拆 
邯 函 数 : 当 所 有 测试 用 例 都 运行 完毕 之 后 ， 测 试 程 序 就 会 直接 退出 。 


上 面 展示 的 代码 只 测试 了 web 服务 的 多 路 复 用 器 以 及 处 理 器 ， 但 它 
并 没有 测试 Web 服 务 的 另 一 个 重要 部 分 。 你 也 许 还 记得 ， 在 本 书 的 第 7 
章 中 ， 我 们 曾经 从 Web 服 务 中 抽 离 出 了 数据 层 ， 并 将 所 有 数据 操作 代码 
都 放置 到 了 data. go 文件 中 。 因 为 测试 handleGet 函数 需要 调用 
Post 结构 的 retrieve 函数 ， 而 测试 handlePut 函数 则 需要 调用 
Post 结构 的 retrieve 函数 以 及 update 函数 ， 所 以 上 述 测试 程序 在 
对 简单 Web 服 务 进行 单元 测试 时 ， 实 际 上 是 在 对 数据 库 中 的 数据 执行 获 
取 操 作 以 及 修改 操作 。 


因为 被 测试 的 操作 涉及 依赖 天 系 ， 所 以 上 述 单元 测试 实际 上 并 不 
征 独立 进行 的 ， 为 了 解决 这 个 问题 ， 我 们 需要 用 到 下 一 节 介 绍 的 技 
术 。 


8.4 WSS RARE A 


WUE (test double) 是 一 种 能 够 让 单元 测试 用 例 变 得 更 为 独立 
的 芝 用 方法 。 当 测试 不 方便 使 用 实际 的 对 象 、 结 构 或 者 函数 时 ， 我 们 
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的 独立 性 ， 所 以 自动 单元 测试 环境 经 常会 使 用 这 种 技术 。 


测试 邮件 发 送 代 码 是 一 个 需要 使 用 测试 奉 身 的 场景 : 很 目 然 地 ， 
你 并 不 布 望 在 进行 单元 测试 时 发 送 真 正 的 邮件 ， 而 解决 这 个 问题 的 一 
种 方法 ， 就 是 创建 出 能 够 模拟 邮件 发 送 操作 的 测试 奉 身 。 同 样 地 ， 为 
了 对 人 简单 Web 服 务 进行 单元 测试 ， 我 们 需要 创建 出 一 些 测 试 蔡 和 喘 ， 并 通 
过 这 些 蕉 身 移 除 单元 测试 用 例 对 真实 数据 库 的 依赖 。 


测试 蔡 身 的 概念 非常 直观 易 懂 一 一 程序 员 要 做 的 束 古 在 进行 自动 
测试 时 ， 创 建 出 测试 奉 身 并 使 用 它们 去 代替 实际 的 函数 或 者 结构 。 然 
而 问题 在 于 ， 使 用 测试 奉 身 需要 在 编码 之 前 进行 相应 的 设计 : 如 果 你 
在 设计 程序 时 根本 没有 考虑 过 使 用 测试 奉 身 ， 那 么 你 很 可 能 无 法 在 实 
际 测试 中 使 用 这 一 技术 。 比 如 ， 上 一 市 展示 的 简单 Web 服 务 的 设计 就 无 
法 在 测试 中 创建 测试 车 员 ， 这 是 因为 对 数据 库 的 依赖 已 经 深 深 地 扎根 
于 这 些 代码 之 中 了 。 


实现 测试 替身 的 一 种 设计 方法 是 使 用 依赖 注入 (dependency 
injection) 设计 模式 。 这 种 模式 通过 回 被 调用 的 对 象 、 结 构 或 者 函数 传 
入 依赖 天 系 ， 然 后 由 依赖 天 系 代 替 被 调用 者 执行 实际 的 操作 ， 以 此 来 
解 厅 软件 中 的 两 个 或 多 个 层 (layer) ， 而 在 Go 语言 当中 ， 被 传 入 的 依 
赖 天 系 通常 会 是 一 种 接口 类 型 。 接 下 来 ， 束 让 我 们 来 看 看 ， 如 何在 第 7 
章 介 绍 的 简单 Web 服 务 中 使 用 依赖 注入 设计 模式 。 


使 用 Go 实现 依赖 注入 


在 第 7 章 介绍 的 简单 Web 服 务 中 ，hand1leRequest 处 理 器 函数 会 
将 GET 请 求 转发 给 handleGet 函数 ， 后 者 会 从 URL 中 提取 文章 的 ID， 
然后 通过 data. go 文件 中 的 retrieve 函数 获取 与 文章 ID 相对 应 的 
Post 结构 。 当 retrieve 玉 数 被 调用 时 ， 它 会 使 用 全 局 的 sql .DB 结 
构 去 打开 一 个 连接 至 PostgreSQL 的 数据 库 连 接 ， 并 在 posts 表 中 查找 
指定 的 数据 。 


图 8-3 展 示 了 简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 。 除 
retrieve 函数 需要 通过 全 局 的 sql .DB 实例 访问 数据 库 之 外 ， 访 问 
数据 库 对 于 其 他 函数 来 说 都 是 透明 的 (transparent) ° 
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图 8-3 ”简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 图 


正如 图 8-3 所 示 ，handleRequest 和 handleGet 都 依赖 于 
retrieve 国 数 ， 而 后 痢 最 终 义 依赖 于 sql ,DB 。 因 为 对 sq1l .DB 的 依 
赖 是 整个 问题 的 根源 ， 所 以 我 们 必须 将 其 移 除 。 


跟 很 多 问题 一 样 ， 解 厢 依 赖 关 系 也 存在 着 好 几 种 不 同 的 方式 ， 既 
可 以 从 底部 开始 ， 对 数据 抽象 层 的 依赖 关系 进行 解 厢 ， 然 后 直接 获取 
sql.DB 结构 ， 也 可 以 从 顶部 开始 ， 将 sql .DB 注入 到 
handleRequest 当中 。 本 节 要 介绍 的 是 后 一 种 方法 ， 也 就 是 以 自 顶 
向 下 的 方式 解 耦 依赖 关系 的 方法 。 


图 8-4 展 示 了 移 除 对 sql . DB 的 依赖 并 将 这 种 依赖 通过 主 程序 注入 
画 数 调用 流程 中 的 具体 方法 。 注 意 ， 问 题 的 关键 并 不 是 避免 使 用 
sq1. DB ， 而 是 避免 对 它 的 直接 依赖 ， 这 样 我 们 才能 够 在 测试 时 使 用 测 
REH 。 
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图 8-4 将 一 个 包含 sq1.DB 的 Post 结构 传递 到 函数 调用 流程 中 ， 以 此 来 对 简单 Web 服 务实 现 
依赖 注入 模式 。 因 为 Post 结构 已 经 包含 了 sql.DB ， 所 以 调用 流程 中 的 所 有 函数 都 不 再 依赖 
sql.DB 


正如 前 面 所 说 ， 为 了 解 厅 被 调用 函数 对 sql .DB 的 依赖 ， 我 们 可 以 
将 sql.DB 注入 handleRequest ， 但 是 把 sq1.DB 实例 或 者 指向 


sql.DBAY 指针 作为 参数 传递 给 handleRequest 对 解决 问题 是 没有 
任何 帮助 的 ， 因 为 这 样 做 只 不 过 是 将 问题 推 给 了 控制 流 的 上 游 。 作 为 
替代 ， 我 们 需要 将 代码 清单 8-12 所 示 的 Text 接口 传递 给 
handleRequest 。 当 测试 程序 需要 从 数据 库 里 面 获取 一 篇 文章 时 ， 
它 可 以 调用 Text 接口 的 方法 ， 并 假设 这 个 方法 知道 自己 应 该 做 什么 以 
及 应 该 返回 什么 数据 。 


代码 清单 8-12 ”传递 给 handleRequest 的 接口 


type Text interface { 
fetch(id int) (err error) 
create() (err error) 


update() (err error) 
delete() (err error) 


接 下 来 ， 我 们 要 做 的 就 是 让 Post 结构 实现 Text 接口 ， 并 将 它 的 
一 个 字段 设置 成 一 个 指向 sq1L,DB 的 指针 。 为 了 让 Post 结构 实现 
Text 接口 ， 我 们 需要 让 Post 结构 实现 Text 接口 拥有 的 所 有 方法 ， 
不 过 由 于 代码 清单 8-12 中 定义 的 Text 接口 原本 就 是 根据 Post 结构 拥 
有 的 方法 定义 而 来 的 ， 所 以 Post 结构 实际 上 已 经 实现 了 Text 接口 。 
代码 清单 8-13 展 示 了 添加 新 字段 之 后 的 Post 结构 。 


代码 清单 8-13 添加 了 新 字段 之 后 的 Post 结构 


type Post struct { 
Db *sql.DB 
Id int ~json:"id"~ 
Content string ~json:"content"~ 
Author string ~json:"author"~ 


| 
这 种 做 法 解决 了 将 sql .DB 直接 传递 给 handleRequest 的 问 
题 ， 程 序 并 不 需要 将 sql .DB 传递 给 被 调用 的 函数 ， 它 只 需要 和 之 前 一 
样 ， 向 被 调用 的 函数 传递 Post 结构 的 实例 即 可 ， 而 Post 结构 的 各 个 
方法 也 会 使 用 结构 内 部 的 sql .DB 指针 来 代替 原本 对 全 局 变量 的 访问 。 
因为 handleRequest 函数 还 是 和 以 前 一 样 ， 接 受 Post 结构 作为 参 
数 ， 所 以 它 的 签名 不 需要 做 任何 修改 。 在 根据 新 的 Post 结构 做 相应 的 
修改 之 后 ，handleRequest 函数 如 代码 清单 8-14 所 示 。 


代码 清单 8-14 ”修改 后 的 handleRequest 函数 


func handleRequest(t Text) http.HandlerFunc { ©@ 
return func(w http.Responsewriter, r *http.Request) { © 
var err error 
switch r.Method { 
case "GET": 
err = handleGet(w, r, t) ® 
case "POST": 
err = handlePost(w, r, t) 
case "PUT": 


err = handlePut(w, r, t) 
case "DELETE": 
err = handleDelete(w, r, t) 


if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError ) 
return 


O 传 入 Text 接口 


@ 返回 带 有 正确 签名 的 函数 


© 将 Text 接 口传 递 给 实际 的 处 理 天 


正如 代码 所 示 ， 因 为 handleRequest 函数 已 经 不 再 遵循 
ServeHTTP 方法 的 签名 规则 ， 所 以 它 已 经 不 再 是 一 个 处 理 器 函数 了 。 
这 使 我 们 无 法 再 使 用 HandleFunc 画 数 把 它 与 一 个 URL 绑 定 在 一 起 
He 


为 了 解决 这 个 问题 ， 程 序 再 次 使 用 了 本 书 第 3 革 中 介绍 过 的 处 理 恬 
串联 技术 ， 让 handleRequest 返回 了 一 个 http .HandlerFunc & 
IN O 


之 后 ， 程 序 在 main 函数 里 面 将 不 再 绑 定 handleRequest 函数 到 
URL， 而 是 直接 调用 handleRequest 函数 ， 让 它 返 回 一 个 
http.HandleFunc 函数 。 因 为 被 返回 的 函数 符合 HandleFunc 方法 
的 签名 要 求 ， 所 以 程序 就 可 以 像 之 前 一 样 ， 把 它 用 作 处 理 器 并 与 指定 
的 URL 进 行 绑 定 。 代 码 清单 8-15 展 示 了 修改 后 的 main HA © 


代码 清单 8-15 ”修改 后 的 main 画 数 


func main() { 


Var err error 


db, err := sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
sslmode= 
disable") 
if err != nil { 
panic(err) 
server := http.Server{ 


Addr: ":8080", 


http.HandleFunc("/post/", handleRequest(&Post{Db: db})) @ 
server .ListenAndServe( ) 


O 将 Post 结构 传递 给 handleRequest 函 数 ， 然 后 绑 定 函数 返回 的 处 


注意 ， 程 序 通 过 Post 结构 ， 以 间接 的 方式 将 指向 sq1.DB 的 指针 
传递 给 了 handleRequest 函数 ， 这 束 是 将 依赖 关系 注入 
handleRequest 的 方法 。 代 码 清单 8-16 展 示 了 同样 的 依赖 关系 是 如 何 
被 注入 handleGet KHY ° 


代码 清单 8-16 ”修改 后 的 handleGet 函数 


func handleGet(w http.Responsewriter, r *http.Request, post Text) 
(err error) { © 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
err = post.fetch(id) © 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 
w.Write(output ) 
return 


O 接受 Text 接口 作为 参数 


@ 获取 数据 并 将 其 存储 到 Post 结构 


修改 后 的 handleGet 画 数 跟 之 前 差不多 ， 主 要 区 别 在 于 现在 的 
handleGet 画 数 将 直接 接受 Post 结构 ， 而 不 是 像 以 前 那样 在 内 部 创 
建 Post 结构 。 除 此 之 外 ，handleGet 画 数 现在 会 通过 调用 Post 结 
构 的 fetch 方法 来 获取 数据 ， 而 不 必 再 调用 需要 访问 全 局 sq1.DB 实 
例 的 retrieve 函数 。 代 码 清单 8-17 展 示 了 Post 结构 的 fetch 方法 的 
具体 定义 。 


代码 清单 8-17 新 的 fetch 方法 


func (post *Post) fetch(id int) (err error) { 
err = post.Db.QueryRow("select id, content, author from posts 
where id = 


=$1", id).Scan(&post.Id, &post.Content, &post.Author) 
return 


这 个 fetch 方法 在 访问 数据 库 时 不 需要 使 用 全 局 的 sq1.DB 结 
构 ， 而 征 使 用 被 传人 的 Post 结构 的 Db 字段 来 访问 数据 库 。 如 采 我 们 
现在 编译 并 运行 修改 后 的 简单 Web 服 务 ， 那 么 它 将 和 修改 之 前 的 简单 
Web 服 务 一 样 正常 工作 。 不 同 的 地 方 在 于 ， 修 改 后 的 代码 已 经 移 除了 对 
全 局 的 Sql ,DB 结构 的 依赖 。 


只 要 对 数据 库 的 依赖 还 深 埋 在 代码 之 中 ， 我 们 丈 无 法 对 其 进行 独 
立 的 测试 。 为 此 ， 我 们 在 上 面 伦 了 不 少 功 夫 来 移 除 代码 中 的 依赖 ， 从 
而 使 单元 测试 用 例 可 以 变 得 更 为 独立 。 在 通过 外 部 代码 实现 依赖 注入 
之 后 ， 我 们 接 下 来 束 可 以 使 用 测试 蔡 身 对 程序 进行 测试 了 。 


AlAhandleRequest 函数 能 够 接受 任何 实现 了 Text 接口 的 结 
构 ， 所 以 我 们 可 以 创建 出 一 个 实现 了 Text SOMRE, HEEE 
为 传递 给 handleRequest 函数 的 参数 。 代 人 码 清 单 8-18 展 示 了 一 个 名 为 
FakePost 的 测试 殖 号 ， 以 及 它 为 了 满足 Text 接口 的 要 求 而 实现 的 几 
VST ER 


代码 清单 8-18 FakePost 测试 替 : 


package main 


type FakePost struct { 
Id int 
Content string 
Author string 


func (post *FakePost) fetch(id int) (err error) { 
post.Id = id 
return 


func (post *FakePost) create() (err error) { 
return 


func (post *FakePost) update() (err error) { 
return 


func (post *FakePost) delete() (err error) { 


return 


} 


注意 ， 为 了 进行 测试 ，fetch 方法 会 把 所 有 传递 给 它 的 ID 都 设置 
为 FakePost 结构 的 ID。 此 外 ， 虽 然 FakePost 结构 的 其 他 方法 在 测 
试 时 都 不 会 用 到 ， 但 是 为 了 满足 Text 接口 的 实现 要 求 ， 程 序 还 是 为 每 


个 方法 都 定义 了 一 个 没有 任何 实际 用 途 的 空 方法 。 为 了 保持 代码 的 清 
蜥 ， 这 些 测试 荐 身 代码 被 放 到 了 doubles .go 文件 里 面 。 


接 下 来 ， 我 们 还 需要 在 server_test .go 文件 里 为 handleGet 
函数 加 上 代码 清单 8-19 所 示 的 测试 用 例 。 


代码 清单 8-19 ”将 测试 替 呈 依赖 注入 到 handleRequest 


func TestHandleGet(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest(&FakePost{})) © 


writer := httptest.NewRecorder( ) 
request, _ := http.NewRequest("GET", "/post/i", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 


t.Errorf("Response code is %v", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id !=1 { 

t.Errorf("Cannot retrieve JSON post") 


O 传 入 一 个 FakePost 结构 来 代替 Post 结构 


测试 用 例 现在 不 再 向 handleRequest 传递 Post 结构 ， 而 是 传递 
一 个 FakePost 结构 ， 这 个 结构 束 是 handleRequest 所 需 的 一 切 。 
除 此 之 外 ， 这 个 测试 用 例 跟 之 前 的 测试 用 例 没 有 什么 不 同 。 


为 了 验证 测试 蔡 映 是 否 能 正常 工作 ， 我 们 可 以 在 关闭 数据 库 之 后 
再 次 运行 测试 用 例 。 在 这 种 情况 下 ， 旧 的 测试 用 例 将 会 因为 无 法 连接 


数据 库 而 失败 ， 而 使 用 了 测试 奉 身 的 测试 用 例 则 因为 不 需要 实际 的 数 
据 库 而 一 切 如 常 进行 。 这 也 意味 着 我 们 在 茸 首 了 这 么 久之 后 ， 终 于 可 
以 独立 地 测试 handleGet ERAN ° 


跟 之 前 的 测试 一 样 ， 如 果 handleGet 函数 运作 正常 ， 那 么 测试 就 
会 通过 ;， 否 则 ， 测 试 束 会 失败 。 和 需要 注意 的 是 ， 这 个 测试 用 例 并 没有 
实际 测试 Post 结构 的 fetch 方法 ， 这 是 因为 实施 这 种 测试 需要 对 
posts 表 执 行 预 设 操作 和 拆 纯 操作 ， 而 重复 执行 这 种 操作 会 在 测试 时 
耗费 大 量 的 时 间 。 这 样 做 的 男 一 个 好 处 是 隔离 了 Web 上 服务 的 各 个 部 分 ， 
使 程序 员 可 以 独立 测试 每 个 部 分 ， 并 在 发 现 问题 时 更 准确 地 定位 出 错 
的 部 分 。 因 为 代码 总 是 在 不 断 地 演进 和 变化 当中 ， 所 以 能 够 做 到 这 一 
点 是 非常 重要 的 。 在 代码 不 断 衍 化 的 过 程 中 ， 我 们 必须 保证 后 续 添 加 
的 部 分 不 会 对 前 面 已 有 的 部 分 造成 破坏 。 


8.5 ”第 三 方 Go 测试 库 


testing 包 是 一 种 简单 且 高 效 的 测试 Go 程序 的 方法 ， 它 甚至 还 被 
用 于 验证 Go 目 身 的 标准 库 ， 但 是 为 了 满足 一 些 领 域 淘 望 拥有 更 多 功能 
的 要 求 ， 市 面 上 也 出 现 了 不 少 对 testing 包 进 行 增 强 的 Go 测试 库 。 本 
忆 将 对 Gocheck 和 Ginkgo 这 两 个 流行 的 Go 测试 库 进 行 介绍 。Gocheck 有 是 
两 者 中 较为 简单 的 一 个 ， 它 整合 并 扩展 了 testing 包 ; Ginkgo 能 够 让 
用 户 在 Go 中 实现 行为 驱动 开发 ， 但 这 个 库 比 较 复 杂 ， 而 且 学 习 曲 线 也 
比较 陡峭 。 


8.5.1 ”Gocheck 测 试 包 简 介 


Gocheck 项 目 提供 了 check 包 ， 这 个 包 是 基于 testing 包 构 建 的 
一 个 测 斌 框架， 并且 提供 了 一 系列 特性 来 填补 标准 testing 包 在 特性 
AMAA, ik ARE LF: 


。 以 套件 (suite) 为 单位 对 测试 进行 分 组 ; 

。 为 每 个 测试 套件 或 者 测试 用 例 分 别 设 置 测试 夹具 ; 
。 带 有 可 扩展 检查 器 接口 的 断言 ; 

。 HS teeth SNA, 

。 与 testing 包 紧 密集 成 。 


下 载 并 安 狠 check 包 的 工作 非常 简单 ， 可 以 通过 执行 以 下 命令 来 
完成 : 


go get gopkg.in/check.v1i 


代码 清单 8-20 展 示 了 使 用 check 包 测 试 简单 Web 服 务 的 方法 。 


代码 清单 8-20 ”使 用 check 包 的 server_test .go 


package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 
. "gopkg.in/check.vi" @ 


type PostTestSuite struct {} © 


func init() { 
Suite(&PostTestSuite{}) © 


} 
func Test(t *testing.T) { TestingT(t) } ©@ 


func (s *PostTestSuite) TestHandleGet(c *C) { 


mux := http.NewServeMux() 

mux.HandleFunc("/post/", handleRequest(&FakePost {}) ) 
writer := httptest.NewRecorder( ) 

request, _ := http.NewRequest("GET", "/post/i", nil) 


mux.ServeHTTP(writer, request) 


c.Check(writer.Code, Equals, 200) © 

var post Post © 
json.Unmarshal(writer.Body.Bytes(), &post) © 
c.Check(post.Id, Equals, 1) © 


@ 导入 check 包 中 的 标识 符 ， 使 程序 可 以 以 不 带 前 缀 的 方式 访问 它 


们 
@ 创建 测试 套件 
© 注册 测试 套件 
© 集成 testing 包 


O 检查 语句 的 执行 结果 


个 测试 程序 做 的 第 一 件 事 就 是 导入 包 。 需 要 特别 注意 的 是 ， 因 
为 程序 是 以 点 C) 方式 导入 check 包 的 ， 所 以 包 中 所 有 被 导出 的 标 
识 符 在 测试 程序 里 面 都 可 以 以 不 带 前 绥 的 方式 访问 。 


之 后 ， 程 序 创建 了 一 个 测试 套件 。 测 试 套件 将 以 结构 的 形式 表 
示 ， 这 个 结构 既 可 以 像 这 个 例子 中 展示 的 一 样 一 一 只 是 一 个 空 结构 ， 
也 可 以 在 结构 中 包含 其 他 字段 ， 这 一 点 在 后 面 将 会 有 更 详细 的 讨论 。 


除了 创建 测试 套件 结构 之 外 ， 程 序 还 需要 把 这 个 结构 传递 给 Suite K 
数 ， 以 便 对 测试 套件 进行 注册 。 测 试 套件 中 所 有 遵循 TestXxx 格式 的 
方法 都 会 被 看 作 是 一 个 测试 用 例 ， 跟 之 前 一 样 ， 这 些 测试 用 例 也 会 在 

用 户 运 行 测试 时 被 执行 。 


准备 工作 的 最 后 一 步 是 集成 testing 包 ， 这 一 点 可 以 通过 创建 一 
个 普通 的 testing 包 测 试用 例 来 完成 : 程序 需要 创建 一 个 格式 为 
TestXxx 的 函数 ， 它 接受 一 个 指 癌 testing .TT 的 指针 作为 输入 ， 然 
后 把 这 个 指针 作为 参数 在 函数 体内 调用 TestingT 函数 。 


上 壕 集 成 操作 会 导致 所 有 用 Suite 函数 注册 了 的 测试 套件 被 运 

行 ， 而 运行 的 结果 则 会 被 回 传 至 testing 包 。 在 一 切 预 设 操作 都 准备 
妥当 之 后 ， 程 序 接 下 来 就 可 以 定义 自己 的 测试 用 例 了 。 在 上 面 展示 的 
测试 套件 当中 ， 有 一 个 名 为 TestHandleGet 的 方法 ， 它 接受 一 个 指 
向 C 类 型 的 指针 作为 参数 ， 这 种 类 型 拥有 一 些 非常 有 趣 的 方法 ， 但 是 由 
于 篇 幅 的 关系 ， 本 节 无 法 详细 介绍 C 类 型 拥有 的 所 有 方法 ， 目 前 来 说 ， 
我 们 只 需要 知道 它 的 Check 方法 和 Assert 方法 能 够 验证 结果 的 值 就 
可 以 了 。 


例如 ， 在 代码 清单 8-20 中 ， 测 试用 例会 使 用 Check 方法 检查 被 返 
回 的 HITP 代 码 是 否 为 200， 如 果 结 果 不 是 200， 那 么 这 个 测试 用 例 将 被 
标记 为 “已 失败 ”， 但 测试 用 例会 继续 执行 直到 结束 ， 反之， 如 果 程 序 
使 用 Assert 来 代替 Check ， 那 么 测试 用 例 在 失败 之 后 将 立即 返回 。 


使 用 Gocheck 实 现 的 测试 程序 同样 使 用 go test 命令 执行 ， 但 是 
用 户 可 以 使 用 check 包 专 有 的 特别 详细 (extra verbose) 标志 - 


check. vv DRE 4247: 


go test -check.vv 


下 面 是 这 条 命令 的 执行 结果 : 


START: server_test.go:19: PostTestSuite.TestGetPost 
PASS: server_test.go:19: PostTestSuite.TestGetPost 0.000s 


OK: 1 passed 
PASS 
ok gocheck 0.007s 


正如 结果 所 示 ， 带 有 特别 详细 标志 的 命令 给 我 们 提供 了 更 多 信 
轧 ， 其 中 包括 测试 的 局 动 信息 。 虽 然 这 些 信息 对 于 目前 这 个 例子 没有 
太 大 帮助 ， 但 是 在 之 后 的 例子 中 ， 我 们 将 会 看 到 这 些 信息 的 重要 之 
处 。 


为 了 观察 测试 程序 在 eee 我 们 可 以 小 小 地 修改 一 下 
handleGet 函数 ， 把 以 下 这 个 会 抛 出 HTTP 404 状 态 码 的 语句 添加 到 
函数 的 return 语句 之 前 : 


http.NotFound(w, r) 


现在 ， 再 执行 go test 命令 ， 我 们 将 看 到 以 下 结 来: 


START: server_test.go:19: PostTestSuite.TestGetPost 
server_test.go:29: 
c.Check(post.Id, Equals, 1) 
. obtained int 0 
. expected int 


1 


FAIL: server_test.go:19: PostTestSuite.TestGetPost 


OOPS: 0 passed, 1 FAILED 
- FAIL: Test (0.00s) 

FAIL 

exit status 1 


FAIL gocheck 0.007s 


正如 结果 所 示 ， 带 有 特别 详细 标志 的 go test 命令 在 测试 出 错时 
将 给 我 们 提供 非常 多 有 价值 的 信息 。 


测试 夹具 (test fixture) 是 check 包 提 供 的 另外 一 个 非常 有 用 的 特 
PE, E eee ee 然后 
再 在 测试 中 对 预期 的 状态 进行 检查 。 


check 包 为 整个 测试 套件 以 及 每 个 测试 用 例 分 别提 供 了 一 系列 预 
设 画 数 和 拆 纯 画 数 。 比 如 ， 在 套件 开始 运行 之 前 运行 一 次 的 
SetUpSuite 函数 ， 在 所 有 测试 都 运行 完毕 之 后 运行 一 次 的 
TearDownSuite 函数 ， 在 运行 每 个 测试 用 例 之 前 都 会 运行 一 次 的 
SetUpTest 函 数 ， 以 及 在 运行 每 个 测试 用 例 之 后 都 会 运行 一 次 的 
TearDownTest 函数 。 


为 了 演示 这 些 测试 夹具 的 使 用 方法 ， 我 们 需要 复 用 之 前 展示 过 的 
测试 程序 ， 并 为 PUT 方法 添加 一 个 测试 用 例 。 如 果 我 们 仔细 地 观察 已 
有 的 测试 用 例 和 新 添加 的 测试 用 例 束 会 发 现 ， 在 每 个 测试 用 例 里 面 ， 
都 出 现 了 以 下 重复 代码 : 


mux := http.NewServeMux() 
mux.HandleFunc("/post/", handlePost(&FakePost {}) ) 


writer := httptest.NewRecorder() 


个 测试 程序 的 每 个 测试 用 例 都 会 创建 一 个 多 路 复 用 器 ， 并 调用 
多 路 复 用 需 的 HandleFunc 方法 ， 把 一 个 URL 和 一 个 处 理 器 绑 定 起 
来 。 在 此 之 后 ， 测 试用 例 还 需要 创建 一 个 ResponseRecorder 来 记录 
请 求 的 响应 。 因 为 测试 套件 中 的 每 个 测试 用 例 都 需要 执行 这 两 个 步 
骤 ， 所 以 我 们 可 以 把 这 两 个 步骤 用 作 各 个 测试 用 例 的 夹具 。 


代码 清单 8-21 展 示 了 使 用 夹具 之 后 的 server_test.go。 


代码 清单 8-21 使 用 测试 夹具 实现 的 测试 程序 


package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 
"strings" 
. "gopkg.in/check.vi" 


type PostTestSuite struct { @ 
mux *http.ServeMux 
post *FakePost 
writer *httptest.ResponseRecorder 
} 


func init() { 
Suite(&PostTestSuite{}) 


} 
func Test(t *testing.T) { TestingT(t) } 


func (s *PostTestSuite) SetUpTest(c *C) { © 
s.post = &FakePost{} 
s.mux = http.NewServeMux() 
s.mux.HandleFunc("/post/", handleRequest(s.post) ) 
s.writer = httptest.NewRecorder() 


} 


func (s *PostTestSuite) TestGetPost(c *C) { 
request, _ := http.NewRequest("GET", "/post/i", nil) 
s.mux.ServeHTTP(s.writer, request) 


c.Check(s.writer.Code, Equals, 200) 

var post Post 
json.Unmarshal(s.writer.Body.Bytes(), &post) 
c.Check(post.Id, Equals, 1) 


func (s *PostTestSuite) TestPutPost(c *C) { 


json := strings.NewReader(°{"content": "Updated 
post", "author":"Sau 
Sheong") ) 
request, _ := http.NewRequest("PUT", "/post/i", json) 


s.mux.ServeHTTP(S.writer, request) 


c.Check(s.writer.Code, Equals, 200) 
.Check(s.post.Id, Equals, 1) 
.Check(s.post.Content, Equals, "Updated post") 


a0 


OFRENE FAM HØJE 


@ 创建 测试 夹具 


为 了 使 用 测试 夹具 ， 程 序 必 须 将 它 的 数据 存储 在 某 个 地 方 ， 并 让 
这 些 数据 在 测试 过 程 中 一 直 存 在 。 为 此 ， 程 序 需 要 给 测试 套件 结构 
PostTestSuite 添加 一 些 字段 ， 并 把 想 要 存储 的 测试 夹具 数据 记录 

到 这 些 字 段 里 面 。 因 为 测试 套件 中 的 每 个 测试 用 例 实际 上 都 是 
PostTestSuite 结构 的 一 个 方法 ， 所 以 这 些 测试 用 例 将 能 够 非常 方 
便 地 访问 到 结构 中 存储 的 夹具 数据 。 在 存储 好 夹具 数据 之 后 ， 程 序 会 
使 用 SetUpTest 函数 为 每 个 测试 用 例 设置 夹具 。 


在 创建 夹具 的 过 程 中 ， 程 序 使 用 了 存储 在 PostTestSuite 结构 
中 的 字段 。 在 设置 好 夹具 之 后 ， 我 们 就 可 以 对 测试 程序 做 相应 的 修改 


T: 需要 修改 的 地 方 并 不 多 ， 最 主要 的 工作 是 移 除 测试 用 例 中 重复 出 
现 的 语句 ， 并 将 测试 用 例 中 使 用 的 结构 修改 为 测试 夹具 中 设置 的 结 
构 。 在 完成 修改 之 后 再 次 执行 go test 命令 ， 我 们 将 得 到 以 下 结 


START: server_test.go:31: PostTestSuite.TestGetPost 
START: server_test.go:24: PostTestSuite.SetUpTest 
PASS: server_test.go:24: PostTestSuite.SetUpTest ©.000s 


PASS: server_test.go:31: PostTestSuite.TestGetPost 0.000s 


START: server_test.go:41: PostTestSuite.TestPutPost 
START: server_test.go:24: PostTestSuite.SetUpTest 


PASS: server_test.go:24: PostTestSuite.SetUpTest 0.000s 
PASS: server_test.go:41: PostTestSuite.TestPutPost 0.000s 
OK: 2 passed 


PASS 
ok gocheck 0.007s 


等 别 详细 标志 让 我 们 请 晰 地 看 到 了 整个 测试 套件 的 运行 过 程 。 为 
了 进一步 观察 整个 测试 套件 的 运行 顺序 ， 我 们 可 以 把 以 下 测试 夹具 画 
数 添 加 到 测试 程序 里 面 : 


func (s *PostTestSuite) TearDownTest(c *C) { 
c.Log("Finished test - ", c.TestName()) 


func (s *PostTestSuite) SetUpSuite(c *C) { 
c.Log("Starting Post Test Suite") 


func (s *PostTestSuite) TearDownSuite(c *C) { 
c.Log("Finishing Post Test Suite") 


再 次 运行 测试 将 得 到 以 下 结 末 : 


START: server_test.go:35: PostTestSuite.SetUpSuite 
Starting Post Test Suite 
PASS: server_test.go:35: PostTestSuite.SetUpSuite 0.000s 


START: server_test.go:44: PostTestSuite.TestGetPost 
START: server_test.go:24: PostTestSuite.SetUpTest 
PASS: server_test.go:24: PostTestSuite.SetUpTest ©.000s 


START: server_test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestGetPost 
PASS: server_test.go:31: PostTestSuite.TearDownTest 0.000s 


PASS: server_test.go:44: PostTestSuite.TestGetPost 0.000s 


START: server_test.go:54: PostTestSuite.TestPutPost 
START: server_test.go:24: PostTestSuite.SetUpTest 
PASS: server_test.go:24: PostTestSuite.SetUpTest ©.000s 


START: server_test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestPutPost 
PASS: server_test.go:31: PostTestSuite.TearDownTest 0.000s 


PASS: server_test.go:54: PostTestSuite.TestPutPost 0.000s 
START: server_test.go:39: PostTestSuite.TearDownSuite 


Finishing Post Test Suite 
PASS: server_test.go:39: PostTestSuite.TearDownSuite 0©.000s 


OK: 2 passed 


gocheck 0.007s 


根据 测试 结果 显示 ，SetUpSuite 和 TearDownSuite 就 如 我 们 
之 前 介绍 的 一 样 ， 只 会 在 测试 开始 之 前 和 测试 结束 之 后 各 运行 一 次 ， 
而 SetUpTest 和 TearDownTest 则 会 作为 每 个 测试 用 例 的 第 一 行 语 
句 和 最 后 一 行 语句 ， 在 测试 用 例 的 开头 和 结尾 分 别 运 行 一 次 。 


作为 testing 包 的 增强 版 本 ， 人 简单 而 强大 的 Gocheck 为 我 们 的 测 
试 “军火 库 ? 加 上 了 一 件 强 有 力 的 武器 ， 如 采 你 想 要 获得 比 Gocheck 更 强 
大 的 功能 ， 可 以 试 一 试 下 一 市 介绍 的 Ginkgo 测 试 框架 。 


8.5.2 Ginkgo 测试 框架 简介 


Ginkgo 是 一 个 行为 驱动 开发 (behavior-driven development, 
BDD) 风格 的 Go 测试 框架 。BDD 是 一 个 非常 庞大 的 主题 ， 想 要 在 小 小 
的 一 六 篇 幅 里 对 它 进 行 完 整 的 介绍 是 不 可 能 的 。 一 言 以 英之 ，BDD 是 
测试 驱动 开发 ”(test-driven development, TDD) 的 一 种 延伸 ， 但 BDD 
跟 TDD 的 不 同 之 处 在 于 ，BDD 是 一 种 软件 开发 方法 而 不 是 一 种 软件 测 


试 方法。 在 BDD 中 ， 软 件 由 它 的 目标 行为 进行 定义 ， 这 些 目 标 行为 通 
党 是 一 系列 业务 需求 。BDD 的 需求 是 从 行为 的 角度 ， 通 过 终端 用 户 的 
语言 以 及 视角 来 定义 的 ， 这 些 需 求 在 BDD 中 称 为 用 户 故 事 (user 
story) 。 下 面 是 通过 用 户 故事 对 简单 Web 服 务 进行 描述 的 一 个 例子 。 


故事 : 
获取 一 张 帖子 
为 了 


向 用 户 显示 指定 的 一 张 帖子 


一 个 被 调用 的 程序 


获取 用 户 指定 的 帖子 


一 个 值 为 
1 的 帖子 ID 
只 


AN 


我 发 送 一 个 带 有 该 ID 的 GET 请 求 
那么 


我 就 会 获得 与 给 定 ID 相 对 应 的 一 张 帖 子 
情景 2: 


吏 用 一 个 非 整 数 ID 
定 


一 个 值 为 ~"hello" 


` 的 帖子 ID 
口 


7N 


我 发 送 一 个 带 有 该 ID 的 GET 请 求 
那么 


我 就 会 获得 一 个 HTTP 500 响 应 


在 定义 了 用 户 故 事 之 后 ， 我 们 束 可 以 把 这 些 用 户 故 事 转 换 为 测试 
用 例 。BDD 中 的 测试 用 例 跟 TDD 中 的 测试 用 例 一 样 ， 都 是 在 编写 实际 
的 代码 之 前 编写 的 ， 这 些 测试 用 例 的 目标 在 于 开发 出 一 个 程序 ， 让 它 
能 够 执行 用 户 故 事 中 描述 的 行为 。 坦 白地 说 ， 上 面 展示 的 用 户 故事 带 
有 很 明显 的 虚构 成 分 。 在 更 现实 的 环境 中 ，BDD 用 户 故 事 最 开始 通 肖 
都 是 使 用 更 高 层次 的 语言 来 撰写 ， 然 后 根据 细 市 进行 数 次 层级 划分 之 
Ja, Bohn BARA ARS, BA, RAR Se SA 
户 故 事 将 会 被 映射 到 一 系列 按 层 级 划分 的 测试 套件 。 


Ginkgo 是 一 个 拥有 丰富 功能 的 BDD 风 格 的 框架 ， 它 提供 了 将 用 户 
故事 映射 为 测试 用 例 的 工具 ， 并 且 这 些 工 具 也 很 好 地 集成 到 了 Go 的 
testing 包 当 中 。 虽 然 Ginkgo 的 主要 用 于 在 Go 中 实现 BDD， 但 是 本 闻 
只 会 把 Ginkgo 当 作 一 个 Go 的 测试 框架 来 使 用 。 


为 了 安装 Ginkgo， 我 们 需要 在 终端 中 执行 以 下 两 条 命令 : 


go get github.com/onsi/ginkgo/ginkgo 


go get github.com/onsi/gomega 


第 一 条 命令 下 载 Ginkgo 并 将 命令 行 接口 程序 ginkgo 安装 到 
$GOPATH/bin 目录 中 ， 而 第 二 条 命令 则 会 下 载 Ginkgo 上 默认 的 匹配 妖 库 
Gomega (匹配 妖 可 以 对 比 两 个 不 同 的 组 件 ， 这 些 组 件 可 以 是 结构 、 映 
射 、 字 符 串 等 ) 


在 开始 学 习 如 何 使 用 Ginkgo 编 写 测试 用 例 之 前 ， 让 我 们 先 来 看 看 
如 何 使 用 Ginkgo 去 执行 已 有 的 测试 用 例 一 一 Ginkgo 能 够 目 动 地 对 前 面 
展示 过 的 testing 包 测 试用 例 进 行 语法 重 写 ， 把 它们 转换 为 Ginkgo 测 
试用 例 。 


为 了 验证 这 一 点 ， 我 们 将 会 使 用 上 一 市 展示 过 的 市 有 依赖 注入 特 
性 的 测试 倒 件 为 起 点 。 如 琳 你 想 要 保留 原 有 的 测试 登 件 ， 让 它们 免 受 
Ginkgo 的 修改 ， 那 么 请 在 执行 后 续 操 作 之 前 先 对 其 进行 备份 。 在 一 切 
准备 束 绪 之 后 ， 在 终 站 里 面 执行 以 下 命令 : 


ginkgo convert . 


这 条 命令 会 在 目录 中 添加 一 个 名 为 xxx _suite_test.go 的 文件 ， 其 中 
XXX 为 目录 的 名 字 。 这 个 文件 的 具体 内 容 如 代码 清单 8-22 所 示 。 


代码 清单 8-22 ”Ginkgo 测 试 套件 文件 


package main_test 


import ( 
. "github.com/onsi/ginkgo" 
. "github.com/onsi/gomega" 


"testing" 


) 


func TestGinkgo(t *testing.T) { 
RegisterFailHandler (Fail) 
RunSpecs(t, "Ginkgo Suite") 

} 


除 此 之 外 ， 上 述 命 令 还 会 对 server_test ,go 文件 进行 修改 ， 代 
码 清单 8-23 中 以 粗 体 的 形式 展示 了 文件 中 被 修改 的 代码 行 。 


代码 清单 8-23 ”修改 后 的 测试 文件 


package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"strings" 
"github.com/onsi/ginkgo" 


var _ = Describe("Testing with Ginkgo", func() { 


It("get post", func() { 


mux := http.NewServeMux() 

mux.HandleFunc("/post/", handleRequest (&FakePost {}) ) 
writer := httptest.NewRecorder() 

request, _ := http.NewRequest("GET", "/post/i", nil) 


mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
GinkgoT().Errorf("Response code is %v", writer.Code) 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id !=1 { 

GinkgoT().Errorf("Cannot retrieve JSON post") 


} 
}) 


It("put post", func() { 


mux := http.NewServeMux() 
post := &FakePost{} 
mux.HandleFunc("/post/", handleRequest (post) ) 


writer := httptest.NewRecorder() 
json := strings.NewReader( > {"content": "Updated 
post", "author":"Sau 
Sheong") ) 
request, _ := http.NewRequest("PUT", "/post/i", json) 


mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
GinkgoT().Error("Response code is %v", writer.Code) 


} 


if post.Content != "Updated post" { 
GinkgoT().Error("Content is not correct", post.Content ) 


}) 


}) 


注意 ， 修 改 后 的 测试 程序 并 没有 使 用 Gomega， 只 是 把 检查 执行 结 
果 的 语句 改 成 了 Ginkgo 提 供 的 Errorf 函数 和 Erro r 函 数 ， 不 过 这 两 个 


函数 跟 testing 包 以 及 check 包 中 的 同名 函数 具有 相似 的 作用 。 当 我 
们 使 用 以 下 命令 运行 这 个 测试 程序 时 : 


Ginkgo 将 打印 出 一 段 格式 非 第 党 腕 的 输出 : 


Running Suite: Ginkgo Suite 


Random Seed: 1431743149 
Will run 2 of 2 specs 
Testing with Ginkgo 
get post 
server_test.go:29 


Testing with Ginkgo 
put post 
server_test.go:48 


Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | 0 Failed | © Pending | 0 Skipped PASS 


Ginkgo ran 1 suite in 577.104764ms 
Test Suite Passed 


自动 转换 已 有 的 测试 ， 然 后 漂亮 地 打印 出 它们 的 执行 结果 ， 这 给 
人 的 感觉 真 的 非常 不 错 ! 但 如 果 我 们 根本 没有 现成 的 测试 用 例 ， 有 是 否 
需要 先 创建 出 testing 包 的 测试 用 例 ， 然 后 再 把 它们 转换 为 Ginkgo 测 
WIE? BREDEN! 没有 必要 多 此 一 举 ， 让 我 们 来 看 看 如 何 从 零 开 
始 创建 Ginkgo 测 试用 例 吧 。 


Ginkgo 提 供 了 一 些 实用 工具 ， 它 们 能 够 帮助 用 户 快 速 、 方 便 地 创 
建 测试 。 首 先 ， 清 空 与 上 一 次 测试 有 关 的 全 部 测试 文件 ， 包 括 之 前 


Ginkgo 创 建 的 测试 套件 文件 ， 然 后 在 程序 的 目录 中 执行 以 下 两 条 命 


ginkgo bootstrap 


ginkgo generate 


第 一 条 命令 会 创建 新 的 Ginkgo 测 试 套 件 文件 ， 而 第 二 条 命令 则 会 
为 测试 用 例文 件 生 成 代码 清单 8-24 所 示 的 骨架 。 


代码 清单 8-24 ”Ginkgo 测试 文件 


package main_test 


import ( 
. "<path/to/your/go_files>/ginkgo" 
. "github.com/onsi/ginkgo" 


. "github.com/onsi/gomega" 


_ = Describe("Ginkgo", func() { 


注意 ， 因 为 Ginkgo 会 把 测试 用 例 从 main 包 中 隔离 开 ， 所 以 新 创建 
的 测试 文件 将 不 再 属于 main 包 。 此 外 ， 测 试 程序 还 通过 点 导入 (dot 
import) 语法 ， 将 几 个 库 中 包含 的 标识 符 全 部 导入 到 顶层 命名 空间 。 这 
种 导入 方式 并 不 是 必需 的 ，Ginkgo 在 它 的 文档 里 面 提供 了 一 些 关 于 如 
何 避 免 这 种 导入 的 说 明 ， 但 是 在 不 使 用 点 导入 语法 的 情况 下 ， 用 户 必 
须 导出 main 包 中 需要 使 用 Ginkgo 测 试 的 所 有 函数 。 例 如 ， 因 为 我 们 接 
下 来 就 要 对 简单 Web 服 务 的 HandleRequest 函数 进行 测试 ， 所 以 这 个 
函数 一 定 要 被 导出 ， 也 就 是 说 ， 这 个 函数 的 名 字 的 首 字母 必须 大 写 。 


另外 需要 注意 的 是 ，Ginkgo 在 调用 Describe 函数 时 使 用 了 var 
= 这 一 技巧 。 这 种 常用 的 技巧 能 够 在 调用 Describe KSEE, 
避免 引入 init HEX ° 


代码 清单 8-25 展 示 了 使 用 Ginkgo 实 现 的 测试 用 例 代 码 ， 这 些 代 码 是 
由 早 前 搜 写 的 用 户 故 事 映 射 而 来 的 。 


代码 清单 8-25 ”使 用 Gomega 匹 配器 实现 的 Ginkgo 测 试用 例 


package main_test 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"github.com/onsi/ginkgo" 
"github.com/onsi/gomega" 
"gwp/Chapter_8 Testing_Web_Applications/test_ginkgo" 


var _ = Describe("Get a post", func() { @ 
var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost{} 
mux = http.NewServeMux( ) 
mux.HandleFunc("/post/", HandleRequest (post) ) 
writer = httptest.NewRecorder() 


}) 


Context("Get a post using an id", func() { 060 
It("should get a post", func() { 
request, _ := http.NewRequest("GET", "/post/i", nil) 
mux.ServeHTTP(writer, request) 


Expect(writer.Code).To(Equal(200)) © 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 


Expect(post.Id).To(Equal(1) ) 
}) 
}) 


Context("Get an error if post id is not an integer", func() { 6 
It("should get a HTTP 500 response", func() { 
request, _ := http.NewRequest("GET", "/post/hello", nil) 
mux.ServeHTTP(writer, request) 


Expect (writer .Code) .To(Equal(500) ) 


@ 用 户 故 事 
Ə 使 用 Gomega 匹 配器 
© 情景 1 


© 使 用 Gomega 对 正确 性 进行 断言 
© 情景 2 


注意 ， 这 个 测试 程序 使 用 了 来 和 目 Gomega 包 的 匹配 器 : Gomega 是 由 
Ginkgo 开 发 者 开发 的 一 个 断言 包 ， 包 中 的 匹配 硕 都 是 测试 断言 。 跟 使 
用 check 包 时 一 样 ， 测 试 程序 在 调用 Context 范 数 模拟 指定 的 情景 
前 ， 会 完 设 置 好 相应 的 测试 夹具 : 


var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost{} 
mux = http.NewServeMux( ) 
mux.HandleFunc("/post/", HandleRequest(post)) © 


writer = httptest.NewRecorder() 
}) 


@ 对 main 包 中 导出 的 函数 进行 测试 


注意 ， 为 了 从 main 包 中 导出 被 测试 的 处 理 器 ， 我 们 将 处 理 器 的 名 
字 从 原来 的 handleRequest 修改 成 了 首 字 母 大 写 的 HandleRequest 
。 除 使 用 的 是 Gomega 的 断言 之 外 ， 程 序 中 展现 的 测试 场景 跟 我 们 之 前 
使 用 其 他 包 进 行 测试 时 的 场景 非常 类 似 。 下 面 是 一 个 使 用 Gomega 创 建 
的 断言 : 


Expect(post.Id).To(Equal(1) ) 


在 这 个 断言 中 ，post .Id 是 要 测试 的 对 象 ，Edqual 函数 是 匹配 
器 ， 而 1 是 预期 的 结果 。 针 对 我 们 写 的 测试 情景 ， 执 行 ginkgo 命令 将 
REA PÅ: 


Running Suite: Post CRUD Suite 


Random Seed: 1431753578 
Will run 2 of 2 specs 


Get a post using an id 
should get a post 
test_ginkgo_test.go:35 


Get a post using a non-integer id 
should get aHTTP500 response 
test_ginkgo_test.go:44 


Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | 0 Failed | © Pending | 0 Skipped PASS 


Ginkgo ran 1 suite in 648.619232ms 


Test Suite Passed 


好 的 ， 关 于 使 用 Go 对 程序 进行 测试 的 介绍 到 这 里 就 结束 了 ， 在 接 
下 来 的 一 章 中 ， 我 们 将 会 讨论 如 何在 Web 应 用 中 使 用 Go 的 一 个 关键 长 


8.6 小结 


Go 通过 go test 命令 为 用 户 提供 了 内 置 的 测试 工具 ， 并 提供 了 
testing 包 以 便 实现 单元 测试 。 

testing 包 提 供 了 基本 的 功能 测试 以 及 基准 测试 能 力 。 

对 于 Go 语言 来 说 ，Web 应 用 的 单元 测试 可 以 通过 
testing/httptest 包 来 完成 。 

使 用 测试 蔡 身 可 以 让 测试 用 例 变 得 更 加 独立 。 

实现 测试 苦 身 的 一 种 方法 是 使 用 依赖 注入 设计 模式 。 

Go 语言 拥有 许多 第 三 方 测 试 库 ， 其 中 包括 对 Go 的 测试 功能 进行 扩 
展 的 Gocheck 包 ， 以 及 实现 了 行为 驱动 测试 的 Ginkgo 包 。 


第 9 章 发挥 Go 的 并 发 优势 


本 章 主要 内 容 


。 从 原理 上 理解 并 发 和 并 行 
。 学 习 如 何 使 用 goroutine 以 及 通道 
。 在 Web 应 用 中 使 用 并 发 特性 


Go 语言 一 个 广为人知 的 特点 束 是 ， 可 以 更 容易 地 写 出 错误 更 少 的 
并 发 程序 。 本 章 将 介绍 并 发 这 一 技术 ， 并 讨论 Go 语言 的 并 发 模型 以 及 
设计 。 除 此 之 外 ， 我 们 还 会 深入 地 了 解 Go 语 言 为 实现 并 发 而 提供 的 两 
个 特性 ， 它 们 分 别 是 goroutine 以 及 通道 。 在 本 章 的 最 后 ， 我 们 还 会 看 到 
一 个 使 用 Go 并 发 提高 Web 应 用 性 能 的 例子 。 


9.1 并 发 与 并 行 的 区 别 


FF (concurrency) 指 的 是 两 个 或 多 个 任务 在 同一 时 间 段 内 局 
动 、 运 行 并 结束 ， 并 且 这 些 任务 可 能 会 互动 。 以 并 发 形式 执行 的 多 个 
任务 会 同时 存在 ， 这 跟 顺 序 执行 每 次 只 会 存在 一 个 任务 的 情况 正好 相 
反 。 并 发 是 一 个 非常 庞大 且 复 杂 的 主题 ， 本 章 将 会 简单 介绍 这 一 主 


题 。 


并 行 与 并 发 是 两 个 看 上 去 相似 但 实际 上 却 截然 不 同 的 概念 ， 因 为 
并 发 和 并 行 都 可 以 同时 运行 多 个 任务 ， 所 以 很 多 人 都 把 这 两 个 概念 混 
消 了 。 对 于 并 发 来 说 ， 多 个 任务 并 不 需要 同时 开始 或 者 同时 结束 
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被 调度 ， 并 且 它 们 会 通过 通信 分 享 数 据 并 协调 执行 时 间 〈 不 过 这 种 通 
信 并 不 是 必须 的 ) 。 


在 并 行 (parallelism) 中 ， 多 个 任务 将 同时 局 动 并 执行 。 并 行 通 常 
会 把 一 个 大 任务 分 割 成 多 个 更 小 的 任务 ， 然 后 通过 同时 执行 这 些小 任 
务 来 提高 性 能 。 并 行 通常 需要 独立 的 资源 (如 CPU) ， 而 并 发 则 会 使 
用 和 分 享 相同 的 资源 。 因 为 并 行 考虑 的 是 同时 启动 和 执行 多 个 任务 ， 
所 以 它 在 直觉 上 会 更 易 展 一 些 。 并 行 ， 正 如 它 的 名 字 所 昭示 的 那样 ， 
征 一 系列 相互 平行 、 不 会 重 杰 的 处 理 过 程 。 


并 发 指 的 是 同时 处 理 多 项 任务 ， 而 并 行 指 的 是 同时 执行 多 项 任务 。 


Rob Pike，Go 语 言 的 作者 之 一 


理解 并 发 的 另 一 种 方法 是 把 它 看 作 超市 里 的 两 条 结账 通道 ， 但 这 
两 条 通道 上 的 顾客 需要 在 一 个 收银 台 排 队 等 候 ， 并 轮流 使 用 这 个 收银 
台 结 账 ， 如 图 9-1 所 示 。 


图 9-1 并 发 一 一 两 条 结账 通道 


， 但 是 只 有 一 个 收银 台 
男 一 方面 ， 并 行 同样 拥有 两 条 结账 通道 ， 只 是 每 条 通道 都 有 一 个 
对 应 的 收银 台 为 顾客 服务 ， 如 图 9-2 所 示 。 


图 9-2 并行 一 一 两 条 结账 通道 


， 每 条 都 对 应 一 个 收银 台 


尽管 并 发 和 并 行 在 概念 上 并 不 相同 ， 但 它们 并 不 相互 排斥 ， 比 如 
Go 语言 就 可 以 创建 出 同时 具有 并 发 和 并 行 这 两 种 特征 的 程序 。 为 了 让 
并 行程 序 可 以 同时 运行 多 个 任务 ，Go 语 言 的 用 户 需要 将 环境 变量 
GOMAXPROCS 的 值 设置 成 大 于 1“。 在 Go 1.5 版 本 之 前 ，GOMAXPROCS 
默认 会 被 设置 为 1 ， 但 是 从 Go 1.5 版 本 开始 ，GOMAXPROCS 默认 将 被 设 
置 为 系统 可 用 的 CPU 数量 。 但 是 ， 并 发 程序 可 以 在 单个 CPU 上 运行 ， 
至 于 程序 包含 的 多 个 任务 则 会 通过 调度 独立 地 运行 ， 本 章 稍 后 就 会 出 
现 一 个 这 样 的 例子 。 需 要 注意 的 是 ， 尽 管 Go 语言 可 以 用 于 创建 并 行程 
序 ， 但 这 门 语言 在 设计 时 考虑 的 更 多 是 并 发 而 不 是 并 行 。 


Go 语言 通过 goroutine 和 通道 这 两 个 主要 组 件 来 为 并 发 提供 文 持 ， 
在 接 下 来 几 方 中， 我 们 将 会 看 到 使 用 goroutine、 通 道 以 及 一 些 标 准 库 来 
构建 并 发 程序 的 具体 方法 。 


9.2 goroutine 


goroutine 指 的 是 那些 独立 于 其 他 goroutine 运 行 的 函数 。 这 一 概念 初 
看 上 去 和 线程 有 些 相 似 ， 但 实际 上 goroutine 并 不 是 线程 ， 它 只 是 对 线程 
的 多 路 复 用 。 因 为 goroutine 都 是 轻 量 级 的 ， 所 以 goroutine 的 数量 可 以 比 
线程 的 数量 多 很 多 。 一 个 goroutine 在 启动 时 只 需要 一 个 非常 小 的 栈 ， 并 
且 这 个 栈 可 以 按 需 扩展 和 缩小 (在 Go 1.4 中 ，goroutine 启 动 时 的 栈 大 小 
MA2KBU!) 。 当 一 个 goroutine 被 阻塞 时 ， 它 也 会 阻塞 所 复 用 的 操作 
系统 线程 ， 而 运行 时 环境 (runtime) 则 会 把 位 于 被 阻塞 线程 上 的 其 他 
goroutine 移 动 到 其 他 未 阻塞 的 线程 上 继续 运行 。 


9.2.1 ”使 用 goroutine 


goroutine 的 用 法 非常 简单 : 只 要 把 go 关键 字 添 加 a 到 任意 一 个 具名 
函数 或 者 匿名 函数 的 前 面 ， 该 函数 殉 会 成 为 一 个 goroutine。 作 为 例子 ， 
代码 清单 9-1 展 示 了 如 何在 名 为 goroutine .go 的 文件 中 创建 


goroutine ° 


代码 清单 9-1 goroutine 使 用 示例 


package main 


func printNumbers1() { 
for i := 0; i < 10; i+ { 
fmt.Printf("%d ", i) 


} 


func printLetters1() { 
for i := 'A'; i < 'A'+10; i++ 4 
fmt.Printf("%c ", i) 


} 


func print1() { 
printNumbers1( ) 
printLetters1() 


func goPrint1() { 
go printNumbers1() 
go printLetters1() 


func main() { 
} 


goroutine ,go 文件 中 定义 了 printNumbers1 和 
printLettersl 两 个 函数 ， 分 别 用 于 循环 并 打印 数字 和 英文 字母 ， 
其 中 printNumbersl1 会 打印 从 9 到 9 的 所 有 数字 ， 而 
printLettersi 则 会 打印 从 A 到 J 的 所 有 英文 字母 。 除 此 之 外 ， 


goroutine ,go 文件 中 还 定义 了 print1 和 goPrint1 两 个 函数 ， 前 
者 会 依次 调用 printNumbers1 和 printLetters1 ， 而 后 者 则 会 以 
goroutine 的 形式 调用 printNumbers1 和 printLetters1。 


为 了 检测 这 个 程序 的 运行 时 间 ， 我 们 将 通过 测试 而 不 是 main 函数 
来 运行 程序 中 的 print1 函数 和 goPrint1l 函数 。 这 样 一 来 ， 我 们 就 
不 必 为 了 测量 这 两 个 函数 的 运行 时 间 而 编写 测量 代码 ， 这 也 避免 了 因 
为 编写 计时 代码 而 导致 测量 不 准确 的 问题 。 


代码 清单 9-2 展 示 了 测试 用 例 的 具体 代码 ， 这 些 代码 单独 记录 在 了 
goroutine_test .go 文件 当中。 


代码 清单 9-2 ”运行 goroutine 示 例 的 测试 文件 


package main 
import "testing" 


func TestPrinti(t *testing.T) { © 
print1() 


func TestGoPrinti(t *testing.T) { @ 
goPrint1() 


@ 测试 顺序 执行 的 函数 
@ 测试 对 以 goroutine 形式 执行 的 函数 
通过 使 用 以 下 命令 执行 这 一 测试 : 


我 们 将 得 到 以 下 结果 : 


=== RUN TestPrint1 
0123456789 ABCDEFGHI J --- PASS: TestPrinti 
(0.00s) 


=== RUN TestGoPrint1 
- PASS: TestGoPrinti (0.00s) 
PASS 


注意 ， 第 二 个 测试 用 例 并 没有 产生 任何 输出 ， 这 是 因为 该 用 例 在 
它 的 两 个 goroutine 能 够 产生 输出 之 前 吏 已 经 结束 了 。 为 了 让 第 二 个 测试 
用 例 能 够 正常 地 产生 输出 ， 我 们 需要 使 用 time 包 中 的 Sleep 函数 ， 
在 第 二 个 测试 用 例 的 末尾 加 上 一 些 延 迟 : 


func TestGoPrinti(t *testing.T) { 
goPrinti() 
time.Sleep(1 * time.Millisecond) 


} 


这 样 一 来 ， 第 二 个 测试 用 例 束 会 在 该 测试 用 例 结束 之 前 正常 地 产 
生 输 出 了 : 


=== RUN TestPrinti 

0123456789 ABCDEFGHI J --- PASS: TestPrinti 
(0.00s) 

=== RUN TestGoPrinti 


012345678 9ABCDEFGHI J --- PASS: TestGoprint1 
(0.00s) 
PASS 


这 两 个 测试 用 例 都 产生 了 相同 的 结果 。 初 看 上 去 ， 是 否 使 用 
goroutine 似 乎 并 没有 什么 不 同 ， 但 事实 上 ， 这 两 个 测试 用 例 之 所 以 会 产 
生 相 同 的 结果 ， 是 因为 printNumbers1 函数 和 printLettersl K 
数 都 运行 得 如 此 之 快 ， 所 以 是 否 以 goroutine 形 式 运行 它们 并 不 会 产生 任 
何 区 别 。 为 了 更 准确 地 模拟 正常 的 计算 任务 ， 我 们 将 通过 time 包 中 的 
Sleep 函数 人 为 地 给 这 两 个 函数 加 上 一 点 延迟 ， 并 把 带 有 延迟 的 本 数 
重新 命名 为 printNumbers2 和 printLetters2 。 代 码 清单 9-3 展 示 
了 这 两 个 新 函数 ， 跟 原来 的 函数 一 样 ， 它 们 也 会 被 放 在 
goroutine.go 文 件 中 。 


代码 清单 9-3 ”模拟 执行 计算 任务 的 goroutine 


func printNumbers2() { 
for i := 0; i < 10; it+ { 
time.Sleep(1 * time.Microsecond & 
fmt.Printf("%d ", i) @ 


func printLetters2() { @ 
for i := 'A'; i < 'A'+10; i++ { © 


time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i)® 


} 


func goPrint2() { 
go printNumbers2() 
go printLetters2() 
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务 。 为 了 测试 新 添加 的 goPrint2 HA, RPE 
goroutine_test.go 文 件 中 添加 相应 的 测试 用 例 ， 并 且 和 之 前 一 
样 ， 为 了 让 被 测 试 的 函数 能 够 正常 地 产生 输出 ， 测 试用 例 将 在 调用 
goPrint2 函数 之 后 等 符 1hs; 


func TestGoPrint2(t *testing.T) { 
goPrint2() 


time.Sleep(1 * time.Millisecond) 


现在 ， 运 行 测试 用 例 将 得 到 以 下 输出 : 


TestPrint1 
456789ABCDEFGHI J --- PASS: TestPrint1 


TestGoPrint1 
45678 9ABCDEFGHI J --- PASS: TestGoPrint1 


TestGoPrint2 
CD2E3 F4GH516J)7 8 9 --- PASS: TestGoPrint2 


注意 看 TestGoPrint2 函数 的 输出 结果 ， 从 结果 可 以 看 出 ， 程 序 
这 次 并 不 是 先 执 行 printNumbers2 函数 ， 然 后 再 执行 
printLetters2 HA, erste! 


WRB FUT — Vk Main, AATestGoPrint2 函数 的 输出 


结果 的 最 后 一 行 可 能 会 有 所 不 同 : 这 是 因为 printNumbers2 和 
printLetters2 都 是 独立 运行 的 ， 并 且 它 们 都 在 争先 您 后 地 想 要 将 
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试 产生 的 结果 也 会 有 所 不 同 。 唯 一 的 例外 是 ， 如 有 果 你 使 用 的 是 Go 1.5.2 
前 的 版 本 ， 那 么 你 每 次 执行 这 个 测试 都 会 得 到 相同 的 结 采 。 


之 所 以 会 出 现 这 种 情况 ， 是 因为 Go 1.5 之 前 的 版 本 在 用 户 没 有 另行 
设置 的 情况 下 ， 即 使 计算 机 拥有 多 于 一 个 CPU， 它 默认 也 只 会 使 用 一 
个 CPU。 但 是 从 Go 1.5 开 始 ， 这 一 情况 发 生 了 改变 一 一 Go 运行 时 环境 
会 使 用 计算 机 拥有 的 全 部 CPU。 在 Go 1.5 或 以 后 的 版 本 中 ， 用 户 如 果 想 
要 让 Go 运行 时 环境 只 使 用 一 个 CPU， 就 需要 执行 以 下 命令 : 


go test -run x -bench . -cpu 1 


在 执行 了 这 个 命令 之 后 ， 每 次 执行 TestGoPrint2 都 将 得 到 完全 
相同 的 结果 。 


9.2.2 ”goroutine 与 性 能 


在 了 解 了 goroutine 的 运作 方式 之 后 ， 接 下 来 我 们 要 考虑 的 就 是 如 何 
通过 goroutine 来 提高 性 能 。 本 节 在 进行 性 能 测试 时 将 沿用 上 一 节 定 义 的 
printi > goPrinti 等 函数 ， 但 为 了 避免 这 些 画 数 在 并 发 执行 时 输 
出 一 些 乱 糟 糟 的 结果 ， 这 次 我 们 将 把 代码 中 的 fmt .Println 语句 注释 
掉 。 代 码 清单 9-4 展 示 了 为 print1 画 数 和 goPrint1 函数 设置 的 基准 
测试 用 例 ， 这 些 用 例 定 义 在 goroutine_test.,go 文 件 中 。 


代码 清单 9-4 ”为 无 goroutine 和 有 goroutine 的 函数 分 别 创建 基准 测试 用 例 


func BenchmarkPrinti(b *testing.B) { © 
for i := 0; i < b.N; i++ { 


print1() 


} 
func BenchmarkGoPrinti(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
goPrinti() 
} 


@ 对 顺序 执行 的 函数 进行 基准 测试 


@ 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 


在 使 用 以 下 命令 进行 性 能 基准 测试 并 跳 过 功能 测试 之 后 ; 
go test -run x -bench . -cpu 1 
我 们 将 看 到 以 下 结 采 : 


BenchmarkPrint1 100000000 13.9 ns/op 


BenchmarkGoPrint1 1000000 1090 ns/op 


(运行 这 个 测试 只 使 用 了 单个 CPU， 上 有 具体 原因 本 章 稍 后 将 会 说 
到 。) 正如 结果 所 示 ， 画 数 print1 运行 得 非常 快 ， 只 使 用 了 13.9 
ns。 令 人 感到 惊讶 的 是 ， 在 使 用 goroutine 运 行 相同 范 数 时 ， 程 序 的 速度 
居然 慢 了 如 此 之 多 ， 足 足 耗费 了 1090 ns! 出 现 这 种 情况 的 原因 在 于 “天 
下 没有 免费 的 午餐 ”: 无 论 goroutine 有 多 人 么 的 轻 量 级 ， 局 动 goroutine 还 
是 有 一 定 的 代价 的 。 因 为 printNumbers1 函数 和 printLetters1l 


函数 是 如 此 人 徐 单 ， 它 们 执行 的 速度 是 如 此 快 ， 所 以 以 goroutine 方 式 执行 
它们 反而 会 比 顺序 执行 的 代价 更 大 。 


如 果 我 们 对 每 次 送 代 都 带 有 一 定 延 迟 的 printNumbers2 函数 和 
printLetters2 函数 执行 类 似 的 测试 ， 结 果 又 会 如 何 呢 ? 代码 清单 9- 
5 展示 了 goroutine_test .go 文件 中 为 以 上 两 个 函数 设置 的 基准 测 
试用 例 。 


代码 清单 9-5 “为 无 goroutine 和 有 goroutine 的 带 延 迟 函 数 分 别 创建 基准 测试 用 例 


func BenchmarkPrint2(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
print2() 


} 


func BenchmarkGoPrint2(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
goPrint2() 


O 对 顺序 执行 的 函数 进行 基准 测试 
@ 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 


在 运行 这 一 基准 测试 之 后 ， 我 们 将 得 到 以 下 结 末 : 


BenchmarkPrint2 10000 121384 ns/op 


BenchmarkGoPrint2 1000000 17206 ns/op 


这 次 的 测试 结果 跟 上 一 次 的 测试 结 采 有 些 不 同 。 可 以 看 到 ， 以 
goroutine 方 式 执行 print Numbers2 和 printLetters2 的 速度 是 以 顺 
序 方 式 执行 这 两 个 函数 的 速度 的 差不多 7 倍 。 现 在 ， 让 我 们 把 函数 的 迁 
代 次 数 从 10 次 改 为 100 次 ， 然 后 再 运行 相同 的 基准 测试 : 


func printNumbers2() { 
for i := 0; i < 100; i++ { ©@ 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%d ", i) 
} 


} 


func printLetters2() { 
for i := 'A'; i < 'A'+100; i++ { © 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%c ", i) 
} 
} 


O t100 次 而 不 是 10 次 
Ə t100 次 而 不 是 10 次 


下 面 是 这 次 基准 测试 的 结果 : 


BenchmarkPrinti 20000000 86.7 ns/op 
BenchmarkGoPrinti 1000000 1177 ns/op 


BenchmarkPrint2 2000 1184572 ns/op 
BenchmarkGoPrint2 1000000 17564 ns/op 


在 这 次 基准 测试 中 ，print1 函数 的 基准 测试 时 间 是 之 前 的 13 售 ， 
而 goPrint1 函数 的 速度 跟 上 一 次 相 比 没有 出 现 太 大 变化 。 男 一 方 
面 ， 通 过 延迟 模拟 负载 的 函数 的 测试 结果 变化 非常 之 大 一 一 以 顺序 方 


式 执行 的 函数 和 以 goroutine 方 式 执行 的 函数 之 间 ， 两 者 的 执行 时 间 相 差 
了 67 倍 之 多 。 因 为 这 次 基准 测试 的 迭代 次 数 比 之 前 增加 了 10 倍 ， 所 以 
print2 函数 在 进行 基准 测试 时 的 速度 差不多 是 上 次 的 10， 但 对 于 
goPrint2 来 说 ， 和 迭代 10 次 所 需 的 时 间 跟 迭代 100 次 所 需 的 时 间 却 几乎 
是 相同 的 。 


注意 ， 到 目前 为 止 ， 我 们 都 是 在 用 一 个 CPU 执行 测试 ， 但 如 采 我 
们 执行 以 下 命令 ， 改 用 两 个 CPU 执行 带 有 100 次 迭代 的 基准 测试 : 


go test -run x -bench . -cpu 2 


那么 我 们 将 得 到 以 下 结 采 : 


BenchmarkPrinti-2 20000000 87.3 ns/op 
BenchmarkGoPrint2-2 5000000 391 ns/op 
BenchmarkPrint2-2 1000 1217151 ns/op 


BenchmarkGoPrint2-2 200000 8607 ns/op 


因为 print1 函数 以 顺序 方式 执行 ， 无 论 运 行 时 环境 提供 多 少 个 
CPU， 它 都 只 能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 跟 上 一 次 的 测 
试 结果 基本 相同 。 与 此 相反 ，goPrint1 函数 这 次 因为 使 用 了 两 个 
CPU 来 分 担 计算 负 载 ， 所 以 它 的 性 能 提高 了 将 近 3 倍 。 此 外 ， 因 为 
print2 也 只 能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 也 跟 预 料 中 的 一 
样 ， 并 没有 发 生 什 么 变化 。 最 后 ， 因 为 goPrint2 使 用 了 两 个 CPU 来 
分 担 计算 人 负载， 所 以 它 这 次 的 测试 比 之 前 快 了 两 售 。 


现在 ， 如 采 我 们 更 进一步 ， 使 用 4 个 CPU 来 运行 相同 的 基准 测试 ， 
结果 将 会 如 何 ? 
BenchmarkPrint1-4 20000000 90.6 ns/op 


3000000 479 ns/op 
1000 1272672 ns/op 


BenchmarkGoPrint2-4 300000 6193 ns/op 


正如 我 们 预期 的 那样 ，print1 函数 和 print2 函数 的 测试 结果 还 
是 一 如 既往 地 没有 发 生 什 么 变化 。 但 令 人 惊奇 的 是 ， 尽 管 goPrint1 
在 使 用 4 个 CPU 时 的 测试 结果 还 是 比 只 使 用 一 个 CPU 时 的 测试 结果 要 
好 ， 但 使 用 4 个 CPU 的 执行 速度 居然 比 使 用 两 个 CPU 的 执行 速度 要 慢 。 
与 此 同时 ， 虽 然 只 有 40% 的 提升 ,但 goPrint2 在 使 用 4 个 CPU 时 的 成 
绩 还 是 比 使 用 2 个 CPU 时 的 成 绩 要 好 。 使 用 更 多 CPU 并 没有 市 来 性 能 提 
升 反而 导致 性 能 下 降 的 原因 跟 之 前 提 到 的 一 样 : 在 多 个 CPU 上 调度 和 
运行 任务 需要 耗费 一 定 的 资源 ， 如 有 果 使 用 多 个 CPU 带 来 的 性 能 优势 不 
足以 抵消 随 之 而 来 的 额外 消耗 ， 那么 程序 的 性 能 就 会 不 升 反 降 。 


从 上 述 测 斌 我们 可 以 看 出 ， 增 加 CPU 的 数量 并 不 一 定 会 市 来 性 能 
提升 ， 更 重要 的 是 要 理解 代码 ， 并 对 其 进行 基准 测试 ， 以 了 解 它 的 性 
能 特质 。 


9.2.3 “等待 goroutine 


在 上 一 节 中 ， 我 们 了 解 到 程序 启动 的 goroutine 在 程序 结束 时 将 会 被 
粗 骏 地 结束 ， 虽 然 通过 Sleep 函数 来 增加 时 间 延 迟 可 以 避免 这 一 问 
题 ， 但 这 说 到 抵 只 是 一 种 权宜 之 计 ， 并 没有 真正 地 解决 问题 。 虽 然 在 
实际 的 代码 中 ， 程 序 本 身 比 goroutine 更 早 结束 的 情况 并 不 多 见 ， 但 为 了 


避免 意外 ， 我 们 还 是 需要 有 一 种 机 制 ， 使 程序 可 以 在 确保 所 有 goroutine 
都 已 经 执行 完毕 的 情况 下 ， 再 执行 下 一 项 工作 。 


为 此 ，Go 语 言 在 sync 包 中 提供 了 一 种 名 为 等 竺 组 (WaitGroup 
的 机 制 ， 它 的 运作 方式 非常 简单 直接 : 


Sy 
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使 用 Add 方法 为 等 竺 组 的 计数 怖 设置 值 ; 

。 当 一 个 goroutine 完 成 它 的 工作 时 ， 使 用 Done 方法 对 等 竺 组 的 计数 
器 执行 减 一 操作 

调用 wait 方法 ， 该 方法 将 一 直 阻 罕 ， 和 直到 等 每 组 计数 名 的 值 变 
为 0 。 


代码 清单 9-6 展 示 了 一 个 使 用 等 待 组 的 例子 ， 在 这 个 例子 中 ， 我 们 
复 用 了 之 前 展示 过 的 printNumbers2 函数 以 及 printLetters2 Ki 
数 ， 并 为 它们 分 别 加 上 了 1ps 的 延迟 。 


代码 清单 9-6 ”使 用 等 待 组 


package main 


import "fmt" 
import "time" 
import "sync" 
func printNumbers2(wg *sync.WaitGroup) { 
for i := 0; i < 10; i+ { 
time.Sleep(1 * time.Microsecond) 
fmt.Printf("%d ", i) 


} 
wg.Done() © 


func printLetters2(wg *sync.WaitGroup) { 


for i := 'A'; i < 'A'+10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt.Printf("%c ", i) 


} 
wg.Done() © 


func main() { 
var wg sync.WaitGroup © 
wg.Add(2) @ 
go printNumbers2(&wg) 
go printLetters2(&wg) 
wg.Wait() © 


@ 对 计数 器 执行 减 一 操作 


@ 对 计数 器 执行 减 一 操作 
© 声明 一 个 等 行 组 

O Nit Wark EJE 

O 阻塞 到 计数 亏 的 值 为 0 


如 果 我 们 运行 这 个 程序 ， 那 么 它 将 巧妙 地 打印 出 0 A 1B2C3 
D4E5F6G67H8I9J。 这 个 程序 的 运作 原理 是 这 样 的 ; 
它 首先 定义 一 个 名 为 wg 的 WaitGroup 变量 ， 然 后 通过 调用 wg 的 Add 
方法 将 计数 器 的 值 设 置 成 2 ;在 此 之 后 ， 程 序 会 分 别 调用 
printNumbers2 和 printLetters2 这 两 个 goroutine， 而 这 两 个 
goroutine 都 会 在 末尾 对 计数 右 的 值 执行 减 一 操作 。 之 后 程序 会 调用 等 得 
组 的 Wait 方法 ， 并 因此 而 被 阻塞 ， 这 一 状态 将 持续 到 两 个 goroutine 都 


执行 完毕 并 调用 Done WIA AIL o SREP RRA ERA Za, EMRK 
平常 一 样 ， 目 然 地 结束 。 
如 果 我 们 在 某 个 goroutine 里 面 筷 记 了 对 计数 器 执行 减 一 操作 ， 那 么 


等 待 组 将 一 直 阻 窒 ， 直 到 运行 时 环境 发 现 所 有 goroutine 都 已 经 休眠 为 
止 ， 这 时 程序 将 引发 一 个 panic: 


0A1B2C3D4E5F66G7H8 I 9 J fatal error: all goroutines 
are asleep - deadlock! 


等 待 组 这 一 特性 不 仅 简 单 ， 而 且 好 用 ， 它 对 并 发 编程 来 说 是 一 种 
不 可 或 缺 的 工具 。 


9.3 通道 


在 前 一 节 ， 我 们 学 习 了 如 何 通过 go 关键 字 ， 把 普通 函数 转换 为 
goroutine 以 便 让 其 独立 运行 ， 并 在 9.2.2 节 学 习 了 如 何 通 过 等 竺 组 来 同步 
独立 运行 的 多 个 goroutine。 在 这 一 节 ， 我 们 将 要 学 习 的 是 ， 如 何 使 用 通 
道 在 多 个 不 同 的 goroutine 之 间 通 信 。 


通道 就 像 是 一 个 箱子 ， 不 同 的 goroutine 可 以 通过 这 个 箱子 与 其 他 
goroutine 通 信 : 如 有 果 一 个 goroutine 想 要 把 一 项 信息 传递 给 另 一 个 
goroutine， 那 么 它 束 必须 把 该 信息 放置 到 箱子 里 ， 然 后 男 一 个 goroutine 
则 负责 从 箱子 里 取出 被 放置 的 信息 ， 束 像 图 9-3 所 示 的 那样 。 


发 送 者 


goroutine 


接收 者 


goroutine 


Go 的 无 缓冲 通道 


图 9-3 ”把 Go 的 无 缓冲 通道 看 作 是 一 个 箱子 


通道 (channel) 是 一 种 带 有 类 型 的 值 (typed value) ， 它 可 以 让 
不 同 的 goroutine 互 相通 信 。 通 道 用 make 函数 创建 ， 该 函数 在 被 调用 之 
后 将 返回 一 个 指 癌 压 层 数据 结构 的 引用 作为 结果 值 。 比 如 ， 以 下 代码 
就 展示 了 如 何 创建 一 个 由 整数 组 成 的 通道 : 


ch := make(chan int) 


make 郴 数 默 认 创 建 的 都 是 无 缓冲 通道 (unbuffered channel) ， 如 
采用 户 在 创建 通道 时 ， 向 make 函数 提供 了 可 选 的 第 三 个 整数 参数 ， 那 
么 make 函数 将 创建 出 一 个 带 有 给 定 大 小 的 有 组 神通 道 (buffered 
channel) 。 比 如 说 ， 以 下 代码 就 会 创建 出 一 个 大 小 为 10 的 整数 有 缓冲 


通道 : 


ch := make(chan int, 10) 


无 缓冲 通道 是 同步 的 ， 它 了 驶 像 是 一 个 每 次 只 能 容纳 一 件 物体 的 箱 
T: 当 一 个 goroutine 把 一 项 信息 放 入 无 缓冲 通道 之 后 ， 除 非 有 某 个 
goroutine 把 这 项 信息 取 走 ， 否 则 其 他 goroutine 将 无 法 再 向 这 个 通道 放 入 
任何 信息 。 这 也 意味 着 ， 如 果 一 个 goroutine 想 要 疝 一 个 已 经 包含 了 某 项 
言 息 的 无 缓冲 通道 再 放 入 一 项 信息 ， 那 么 这 个 goroutine 将 被 阻塞 并 进入 
休眠 状态 ， 直 到 该 通道 变 空 为 止 。 


同样 地 ， 如 果 一 个 goroutine 笑 试 从 一 个 并 没有 包含 任何 信息 的 无 绥 
冲 通 道中 取出 一 项 信息 ， 那 么 这 个 goroutine 将 会 被 阻 窗 并 进入 休眠 状 
仿 ， 直 到 通道 不 再 为 空 为 止 。 


将 信息 放 入 通道 的 语法 是 非常 直观 的 ， 比 如 ， 通 过 执行 以 下 语 
句 ， 我 们 可 以 把 数字 1 放 入 通道 ch 里 面 : 


ch <- 1 


从 通道 里 面 取出 信息 的 语法 同样 非常 直观 ， 比 如 ， 通 过 执行 以 下 
语句 ， 我 们 可 以 从 通道 ch 里 面 移 除 一 个 值 ， 并 将 该 值 赋值 给 变量 i : 


i := <- ch 


通道 可 以 是 定向 的 (directional) 。 在 默认 情况 下 ， 通 道 将 以 双 辐 
的 (bidirectional) 形式 运作 ， 用 户 既 可 以 把 值 放 入 通道 ， 也 可 以 从 通 


道 取出 值 ; 但是， 通道 也 可 以 被 限制 为 只 能 执行 发 送 操作 (send- 
only) 或 者 只 能 执行 接收 操作 (receive-only) 。 比 如 ， 以 下 语句 就 展 
示 了 如 何 创 建 一 个 只 能 执行 发 送 操作 的 子 符 串通 首 : 


ch := make(chan <- string) 


而 以 下 语句 则 展示 了 如 何 创建 一 个 只 能 执行 接收 操作 的 字符 串通 道 : 


ch := make(<-chan string) 


用 户 除了 可 以 直接 创建 定向 的 通道 之 外 ， 还 可 以 把 一 个 双向 通道 
转变 为 定向 通道 ， 我 们 将 会 在 本 章 的 末尾 看 到 一 个 这 样 的 例子 。 
9.3.1 通过 通道 实现 同步 

也 许 你 已 经 猜 到 了 ， 通 道 非常 适用 于 对 两 个 goroutine 进 行 同步 ， 当 
一 个 goroutine 需 要 依赖 另 一 个 goroutine 时 ， 更 是 如 此 。 事 不 宜 迟 ， 让 我 
们 马上 来 看 看 代码 清单 9-7 所 示 的 程序 : 这 个 程序 沿用 了 上 一 节 展 示 过 


的 例子 ， 唯 一 的 不 同 在 于 ， 这 次 的 程序 使 用 了 通道 而 不 是 等 待 组 来 对 
goroutine 进 行 同步 。 


代码 清单 9-7 使 用 通道 同步 goroutine 


package main 


import "fmt" 
import "time" 


func printNumbers2(w chan bool) { 
for i := 0; i < 10; i+ { 
time.Sleep(1 * time.Microsecond) 


fmt .Printf("%d ", i) 


} 
w <- true @ 

} eo 

func printLetters2(w chan bool) { @ 
for i := 'A'; i < 'A'+10; i++ { © 


time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i) @ 


func main() { 
w1, w2 := make(chan bool), make(chan bool) 
go printNumbers2(w1) 
go printLetters2(w2) 
<-wi @ 


<-w2 @ 
} 


@ 把 一 个 布尔 值 放 入 通道 ， 以 便 解除 主 程序 的 阻塞 状态 


@ 主 程序 将 一 直 阻 塞 ， 直 到 通道 里 面 出 现 可 弹出 的 值 为 止 


ee 函数 。 它 首先 创建 了 w1 和 w2 这 两 个 
bool 类 型 的 通道 ， 接 着 以 goroutine 方 式 运行 了 printNumbers2 函数 
sae ee REN, FERRI a meg ER 文 两 个 图 数 。 在 
eee main 函数 将 会 莹 试 从 通道 w1 中 移 除 一 个 
值 ， 但 由 于 通道 w1 当时 并 没有 包含 任何 值 ， 所 以 main 函数 将 会 在 此 
处 阻塞 。 当 printNumbers2 即将 执行 完毕 ， 并 将 一 个 true 值 放 入 通 
道 w1 Zia, main 函数 的 阻塞 状态 才 会 被 解除 ， 并 继续 尝试 从 第 二 个 
通道 w2 oe 。 跟 之 前 一 样 ， 在 printLetters2 执行 完毕 并 
将 true 值 放 入 通道 w2 之 前 ，main 函数 将 一 直 阻 蹇 ， 直 到 它 成 功 取得 


了 w2 通道 中 的 true 值 之 后 ， 阻 塞 才 会 解除 ， 然 后 main 函数 才 会 顺利 
退出 。 

需要 注意 的 是 ， 因 为 我 们 只 是 想 要 在 goroutine 执 行 完毕 之 后 解除 对 
main 函数 的 阻塞 ， 而 不 是 真正 地 想 要 使 用 通道 中 存储 的 值 ， 所 以 程序 
在 从 通道 w1 和 w2 里 面 取出 值 之 后 并 没有 使 用 这 些 值 。 


代码 清单 9-7 展 示 的 是 一 个 非常 简单 的 例子 ， 这 个 例子 中 的 程序 使 
用 通道 只 是 为 了 对 多 个 goroutine 进 行 同步 ， 但 这 些 goroutine 之 间 并 没有 
通信 。 不 过 在 接 下 来 的 一 方 ， 我 们 就 会 看 到 一 个 在 多 个 goroutine 之 间 传 
递 消息 的 例子 。 


9.3.2 ”通过 通道 实现 消息 传递 


代码 清单 9-8 展 示 了 两 个 以 goroutine 形 式 独立 运行 的 函数 ， 其 中 一 
个 函数 是 投掷 怖 (thrower) ， 它 接受 一 个 通道 作为 参数 ， 然 后 一 个 接 
一 个 地 把 一 组 数字 发 送 到 通道 里 ， 而 另 一 个 函数 则 是 捕捉 需 
(catcher) ， 它 会 从 相同 的 通道 里 一 个 接 一 个 地 取出 一 组 数字 ， 并 把 
这 些 数字 打印 出 来 。 


代码 清单 9-8 ”使 用 通道 实现 消息 传递 


package main 


import ( 
"Fmt " 
UL! time" 


) 


func thrower(c chan int) { 
for i := 0; i < 5; i++ { 
c <-i@® 
fmt.Println("Threw >>", i) 


} 
} 


func catcher(c chan int) { 
for i := 0; i < 5; i++ { 
num := <-c @ 
fmt.Println("Caught <<", num) 


} 


func main() { 
c := make(chan int) 
go thrower (c) 
go catcher(c) 
time.Sleep(100 * time.Millisecond) 


} 


@ 把 数 子 值 推 入 通道 中 


@ 从 通道 中 取出 数 子 值 


Caught << 0 
Threw >> 0 
Threw >> 1 
Caught << 1 


Caught << 2 
Threw >> 2 


Threw >> 3 
Caught << 3 
Caught << 4 
Threw >> 4 


在 这 段 输出 结果 中 ， 某 些 Caught 语句 出 现在 了 Threw 语句 的 前 
面 ， 但 这 并 不 意味 着 程序 的 运行 出 现 了 错误 一 一 之 所 以 会 出 现 这 样 的 
乱 象 ， 仪 仅 是 因为 运行 时 环境 在 疝 通 道 推 入 值 或 者 从 通道 中 取出 值 之 
后 ， 调 度 到 了 打印 语句 所 致 。 最 重要 的 是 ， 打 印 语句 中 出 现 的 数字 都 


EAN, ROS Daas TE AE Bo — MNS Zia, Tea 
须 先 “ 捕 捉 ” 这 个 数字 ， 然 后 才能 处 理 下 一 个 数 子 。 


93.3 ”有 缓冲 通道 


无 缓冲 通道 或 者 说 同步 通道 (synchronous channel) 使 用 起 来 非常 
简单 ， 而 与 之 相对 的 有 缓冲 通道 则 更 复杂 一 些 ， 后 者 是 一 种 异步 的 、 
先进 先 出 消息 队列 。 如 图 9-4 所 示 ， 有 缓冲 通道 就 像 是 一 个 能 够 容纳 多 
个 同类 信息 的 大 箱子 ， 一 个 goroutine 可 以 持续 地 向 箱子 里 面 推 入 信息 ， 
并 且 在 箱子 被 填 满 之 前 ， 推 入 信息 的 goroutine 都 不 会 被 阻塞 ， 同 样 地 ， 
一 个 goroutine 可 以 按照 信息 被 推 入 的 顺序 ， 持 续 地 从 箱子 里 取出 信息 ， 
并 且 在 箱子 被 掏 空 之 前 ， 取 出 信息 的 goroutine 都 不 会 被 阻塞 。 


发 送 者 接收 者 
goroutine goroutine 


BEDE 


Go 的 有 缓冲 通道 


图 9-4 ”将 Go 的 有 缓冲 通道 看 作 和 是 一 个 箱子 


接 下 来 ， 束 让 我 们 看 看 有 缓冲 通道 在 投掷 大 和 捕捉 万 的 例子 中 坪 
如 何 运 作 的 。 为 此 ， 我 们 需要 对 代码 清单 9-8 中 ， 以 下 这 个 创建 无 缓冲 
通道 的 语句 进行 修改 : 


c := make(chan int) 


让 它 转 而 创建 一 个 大 小 为 3 的 有 缓冲 通道 : 


c := make(chan int, 3) 


运行 修改 后 的 程序 ， 我 们 将 得 到 以 下 结 


从 输出 结 打 可 以 看 到 ， 投 掷 禹 将 一 直 辐 通道 推 入 数字 ， 直 到 通道 
被 填 满 并 将 其 阻塞 为 止 ， 而 捕捉 器 则 会 按 顺 序 从 通道 里 取出 被 推 入 的 
数字 。 如 采 你 在 解决 某 个 问题 的 时 候 ， 只 有 有 限 数量 的 工作 进程 可 
用 ， 并 且 你 打算 限制 传 入 请 求 的 数量 ， 那 么 有 缓冲 通道 将 是 一 种 非常 
合适 的 工具 。 


9.3.4 ”从 多 个 通道 中 选择 


Go 拥有 一 个 特殊 的 关键 字 select ， 它 允许 用 户 从 多 个 通道 中 选 
择 一 个 通道 来 执行 接收 或 者 发 送 操作 。select 关键 字 就 像 是 专门 为 通 
道 而 设 的 Switch 语句 ， 代 码 清 单 9-9 展 示 了 一 个 使 用 select 关键 字 
的 例子 。 


代码 清单 9-9 从 多 个 通道 中 选择 


package main 


import ( 
" fmt " 
) 


func callerA(c chan string) { 
c <- "Hello world!" 
} 


func callerB(c chan string) { 
c <- "Hola Mundo!" 
} 


func main() { 
a, b := make(chan string), make(chan string) 
go callerA(a) 
go callerB(b) 
for i := 0; i < 5; i++ { 
select { 
case msg := <-a: 
fmt .Printf("%s from A\n", msg) 
case msg := <-b: 
fmt.Printf("%s from B\n", msg) 


这 个 程序 中 的 callerA 和 callerB 两 个 函数 都 会 接受 一 个 字符 
串通 道 作 为 参数 ， 并 向 该 通道 发 送信 息 。 在 以 goroutine 方 式 调 用 
callerA 和 callerB 之 后 ,程序 会 进行 5 次 从 代 (次 数 的 多 少 无 关 紧 
要 ，5 是 一 个 随意 选取 的 数字 ) ， 并 且 在 每 次 迭代 中 ，Go 的 运行 时 环境 
都 会 根据 通道 a 或 者 通道 b 是 否 有 值 来 决定 应 该 对 哪个 通道 执行 取 值 操 
作 。 如 果 两 个 通道 都 有 值 ， 那 么 Go 运行 环境 将 随机 选择 其 中 一 个 通 
道 。 


我 们 的 计划 听 上 去 似乎 完美 无 瑕 ， 但 是 在 实际 运行 程序 的 时 候 ， 
Go MA BN I PCT: 


Hello World! from A 
Hola Mundo! from B 


fatal error: all goroutines are asleep - deadlock! 


出 现 这 个 错误 的 原因 我 们 前 面 已 经 提 到 过 了 ， 当 一 个 goroutine 取 出 
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通道 获取 值 的 goroutine 都 会 被 阻塞 并 进 并 入 休 眼 状态 。 在 这 个 例子 中 ， 
main 芳 数 首先 在 第 一 次 闪 代 中 从 通道 a 里 取出 了 值 ， 并 导致 通道 a 为 
T: 接着 又 在 第 二 次 友 代 中 从 通道 b 并 导致 通道 b AZ 
然后 在 进行 第 三 次 迭代 时 ，main 函数 发 现 通 道 a 和 通道 b 都 为 空 ， 于 
是 它 就 会 被 阻塞 并 进入 休眠 ， 但 由 于 这 eee nnn ae 
个 goroutine 都 已 执行 完毕 ， 所 以 通道 a 和 通道 b 将 永远 也 不 会 再 有 值 ， 
而 main 函数 也 只 能 永远 等 竺 下 去 一 一 在 检测 到 这 一 情况 之 后 ，Go 运 行 
时 环境 抛 出 了 和 死 锁 错误 。 


解决 这 个 问题 并 不 困难 ， 我 们 只 需要 为 select 语句 添加 一 个 默认 
分 支 ， 让 select 语句 在 所 有 可 选 通道 都 已 被 阻塞 的 情况 下 执行 默认 分 
支 即 可 ， 以 下 代码 中 加 粗 的 部 分 就 是 新 添加 的 默认 分 支 : 


select { 

case msg := < -a: 
fmt.Printf("%s from A\n", msg) 
case msg := < -b: 


fmt.Printf("%s from B\n", msg) 
default: 


fmt .Printin("Default" ) 


select 语句 没有 发 现任 何 可 用 的 通道 时 ， 它 就 会 执行 默认 分 支 
中 的 代码 。 对 于 上 面 的 例子 来 说 ， 当 存储 在 通道 a 和 通道 b 里 面 的 值 都 
被 取出 之 后 ， 程 序 惑 会 在 下 一 次 迭代 中 执行 默认 分 文中 的 代码 。 
是 ， 如 果 现在 就 执行 这 段 代码 就 只 会 看 到 默认 分 支 打印 的 输出 : 
得 及 接受 callerA 和 callerB 发 送 给 它们 的 值 ，select 语句 就 跳 过 
两 个 还 没有 值 的 通道 直接 执行 默认 分 文 了 。 为 了 让 这 个 程序 能 够 正确 
工作 ， 我 们 需要 在 每 次 迭代 之 前 添加 1s 的 延迟 ， 从 而 使 通道 能 够 正常 
接收 goroutine 发 送 给 它们 的 值 ， 以 下 代码 中 加 粗 显示 的 就 是 新 添加 的 语 
fJ: 


for i := 0; i < 5; i++ { 
time.Sleep(1 * time.Microsecond) 


select { 
case msg := < -a: 
fmt.Printf("%s from A\n", msg) 
case msg := < -b: 
fmt.Printf("%s from B\n", msg) 
default: 
fmt .Printin( "Default" ) 
} 


} 


运行 这 个 修改 后 的 程序 ， 死 锁 将 不 会 再 出 现 : 


Hello World! from A 


Hola Mundo! from B 
Default 
Default 
Default 


从 程序 输出 的 结果 可 以 看 到 ， 在 通道 a 和 通道 b 包含 的 值 都 被 取出 
Zia, select 语句 的 前 两 个 分 支 就 会 被 阻塞 ， 而 默认 分 支 则 会 税 执 


ÍT? 


在 循环 里 添加 延迟 时 间 的 做 法 初 看 上 去 会 让 人 感觉 有 些 奇 怪 ， 但 
这 其 实 只 是 为 了 展示 select 语句 的 用 法 而 想 出 来 的 权宜 之 计 。 在 实际 
中 ， 大 部 分 情况 下 用 户 使 用 的 都 是 无 限 循 环 ， 而 不 是 有 限 次 数 的 迭 
代 ， 这 时 程序 的 处 理 方 式 束 会 有 所 不 同 。 比 如 ， 如 果 我 们 古 在 一 个 无 
限 循 环 中 使 用 select 语句， 那么 在 所 有 通道 都 为 空 之 后 ， 程 序 将 无 限 
次 执行 默认 分 文 ， 这 时 我 们 就 可 以 对 默认 分 文 的 执行 次 数 进行 计数 ， 
并 在 计数 到 达 指 定 限制 时 退出 循环 。 


其 实在 实际 中 ， 我 们 并 不 需要 像 上 面 所 说 的 那样 ， 通 过 计数 器 来 
退出 市 有 select 语句 的 无 限 人 循环 ， 这 是 因为 使 用 内 置 的 close KA 
来 关闭 通道 能 够 更 好 地 达到 这 一 目的 : 使 用 close 函数 关闭 通道 ， 相 
当 于 向 通道 的 接收 者 表明 该 通道 将 不 会 再 收 到 任何 值 。 只 能 执行 接收 
操作 的 通道 无 法 被 关 团 ， 兴 试 向 一 个 已 关闭 的 通道 发 送信 息 将 会 引发 
一 个 panic， 壬 试 天 闭 一 个 已 经 被 关闭 的 通道 也 是 如 此 。 壬 试 从 一 个 已 
关闭 的 通道 取 值 总 是 会 得 到 一 个 与 通道 类 型 相对 应 的 零 值 ， 因 此 从 已 
天 闭 的 通道 取 值 并 不 会 导致 goroutine 倍 阻 窟 。 


代码 清早 9-10 展 示 了 一 个 例子 ， 在 这 个 例子 中 ， 我 们 将 会 看 到 关闭 
通道 的 方法 以 及 被 关闭 通道 是 如 何 帮助 程序 跳出 无 限 循 环 的 。 


代码 清单 9-10 ”关闭 通道 


package main 


import ( 
"Fmt" 
) 


func callerA(c chan string) { 
c <- "Hello World!" 
close(c) © 

} eo 


func callerB(c chan string) { ©@ 
c <- "Hola Mundo!" @ 
close(c) © 


func main() { 
a, b := make(chan string), make(chan string) 


go callerA(a) 
go callerB(b) 
var msg string 
oki, ok2 := true, true 
for oki || ok2 { 
select { 
case msg, oki = <-a: @ 
if oki { @ 
fmt.Printf("%s from A\n", msg) © 
} @ 
case msg, ok2 = <-b: @ 
if ok2 { @ 
fmt.Printf("%s from B\n", msg) 


O ENB" ANZ Ja KAS 


@ 在 通道 被 关闭 之 后 ， 变 量 okl 和 ok2 的 值 将 被 设置 为 false 


XAET DEARER, FHA NRE TENA CZ. BIS OY IE] 
延迟 。 在 将 一 个 字符 串 发 送 至 通道 之 后 ， 程 序 调用 内 置 的 close 函数 
关闭 了 该 通道 。 需 要 注意 的 是 ， 跟 关闭 文件 或 者 关闭 套 接 字 不 一 样 ， 
关闭 通道 并 不 会 导致 通道 的 机 能 完全 停止 一 一 它 的 作用 就 是 通知 其 他 
正在 党 试 从 这 个 通道 接收 值 的 goroutine， 这 个 通道 已 经 不 会 再 接收 到 任 
何 值 了 。 


男 外 需要 注意 的 是 ， 程 序 在 从 通道 里 面 取 值 时 ， 使 用 的 是 多 值 格 


zt (multivalue form) : 


case value, oki = <-a 


在 执行 这 条 语句 时 ， 从 通道 a 里 面 取出 的 值 将 被 赋值 给 变量 value 
， 而 变量 ok1 则 会 被 设置 为 用 于 表示 通道 是 否 仍然 处 于 打开 状态 的 布 
Meo HARDEE CRA, IA ok1 的 值 将 被 设置 为 false 。 


对 于 关闭 通道 我 们 需要 知道 的 最 后 一 点 束 是 ， 关 闭 通 道 并 不 是 必 
需 的 。 正 如 之 前 所 说 ， 关 闭 通 道 只 不 过 是 在 告知 接收 者 该 通道 不 会 再 
接收 到 任何 值 而 已 。 在 代码 清单 9-10 剩 余 的 代码 中 ， 程 序 将 通过 检测 语 
句 来 判断 通道 是 否 已 被 关闭 ， 并 在 通道 已 被 天 闭 的 情况 下 ， 跳 出 循 
环 ， 不 再 打印 任何 信息 。 下 面 是 执行 该 程序 得 出 的 结 


Hello World! from A 
Hola Mundo! from B 


9.4 在 web 应 用 中 使 用 并 发 


直到 目前 为 止 ， 本 章 都 是 在 独立 的 程序 中 展示 如 何 使 用 Go 的 并 发 
特性， 但 是 显然 地 ， 这 些 并 发 等 性 不 仅 可 以 在 独立 的 程序 中 使 用 ， 还 
可 以 在 Web 应 用 中 使 用 。 在 这 一 市 中 ， 我 们 将 把 注意 力 放 到 Go Webby 
用 上 ， 并 学 习 如 何 使 用 并 发 特性 去 提高 Go Web 应 用 的 性 能 。 我 们 不 仅 
会 使 用 前 面 已 经 介绍 过 的 一 些 基 础 技术 ， 而 且 还 会 了 解 一 些 出 现在 实 
际 Web 应 用 中 的 并 发 模式 。 


在 本 世 中 ， 我 们 将 要 创建 一 个 对 图 片 进行 马赛 元 处理 ， 以 此 来 生 
成 马赛 克 图 片 的 Web 应 用 。 对 图 片 进行 马赛 元 (mosaic) 处 理 ， 指 的 
征 将 图 片 分 割 成 多 个 (通常 是 大 小 相同 的 ， 和 矩形 截面 ， 然 后 使 用 一 些 
BPA RIGA (tile picture) 的 者 图 片 去 代替 截面 原 有 的 图 片 。 马 赛 
殉 岁 片 的 奇妙 之 处 在 于 ， 如 采 人 们 从 足够 远 的 地 方 观察 ， 或 者 以 冬 视 
的 角度 观察 ， 束 会 看 到 图 片 在 进行 马赛 区 处理 之 前 的 样子 ， 相 反 ， 如 
条 人 们 趴 近 去 观 守 马 赛区 岁 片 ， 束 会 发 现 它 们 其 实 是 由 成 百 上 千张 太 
寸 更 小 的 瓷砖 图 片 组 成 。 


这 个 生成 马赛 克 图 片 的 Web 应 用 的 基本 想法 非常 简单 ， 它 接收 用 户 
上 传 的 目标 图 片 、(target picture) ， 然 后 据 此 生成 相应 的 马赛 克 图 片 。 
为 了 让 事情 保持 人 简单， 我 们 假设 侈 砖 图 片 已 经 事先 准备 好 了 ， 并 且 它 
们 都 已 经 被 裁 况 到 了 合适 的 大 小 。 


9.4.1 创建 马赛 克 图 片 


创建 马赛 区 图 片 的 第 一 步 是 定义 一 个 马赛 元 算法 ， 下 面 是 一 个 无 
需 使 用 任何 第 三 方 库 的 算法 步骤 。 


(1) 通过 扫描 图 片 目录 ， 并 使 用 图 片 的 文件 名 作为 键 、 图 片 的 平 
均 凑 色 作 为 值 ， 构 建 出 一 个 由 次 砖 图片 组 成 的 散 列 ， 也 束 古 一 个 之 砖 
图 片 数 据 库 。 通 过 计算 图 片 中 每 个 像素 红 、 绿 、 蓝 3 种 关 色 的 态 和 ， 并 
将 它们 除 以 像素 的 尽数 量 ， 我 们 束 得 到 了 一 个 三 元 组 ， 而 这 个 三 元 组 
束 古 图 片 的 平均 颜色 。 


(2) 根据 之 砖 图 片 的 大 小 ， 将 目标 图 片 切 割 成 一 系列 尺寸 更 小 的 
TRAR? 


3) 对 于 目标 图 片 切割 出 的 每 张 子 图 片 ， 将 它们 位 于 左上 方 的 第 
一 个 像素 设 定 为 该 图 乒 的 平均 颜色 。 


(4) 根据 子 图 片 的 平均 颜色 ， 在 瓷砖 图 片 数 据 库 中 找 出 一 张 平均 
颜色 与 之 最 为 接近 的 大 看 图 片 ， 然 后 在 目标 图 片 的 相应 位 置 上 使 用 党 
砖 图 片 去 代替 原 有 的 子 图 片 。 为 了 找 出 最 接近 的 平均 颜色 ， 程 序 需 要 
将 子 图 片 的 平均 颜色 以 及 纺 夸 图片 的 平均 颜色 部 转换 成 三 维 空间 中 的 
一 个 点 ， 并 计算 这 两 点 之 间 的 欧 几 里 得 距离 。 


(5) 当 一 张 瓷砖 图 片 被 选中 之 后 ， 程 序 就 会 把 这 张 图 片 从 资 砖 图 
片 数据 库 中 移 除 ， 以 此 来 保证 马赛 元 图 片 中 的 每 张 碗 砖 图 片 都 是 独 一 
无 二 、 各 不 相同 的 。 


文件 mosaic ,go 实现 了 上 述 的 马赛 克 算 法 ， 我 们 接 下 来 将 逐一 分 
析 该 文件 包含 的 各 个 函数 。 首 先 ， 代 码 清单 9-11 展 示 了 该 文件 中 用 于 计 
算 平均 颜色 的 averageColor 函数 。 


代码 清单 9-11 averageColor 函数 


func averageColor(img image.Image) [3]float64 { 
bounds := img.Bounds() 
r, g, := 0.0, 0.0, 0.0 
for y := bounds.Min.Y; y < bounds.Max.Y; y++ { 
for x := bounds.Min.X; x < bounds.Max.X; x++ { 
ri, gi, b1, _ := img.At(x, y).RGBA() 


r, g, b = r+float64(r1), g+float64(g1), b+float64(b1) @ 
} 


totalPixels := float64(bounds.Max.X * bounds.Max.Y) 
return [3]float64{r / totalPixels, g / totalPixels, b / 
totalPixels} 


@ 计算 出 给 定 图 片 的 平均 颜色 


averageColor 琅 数 会 把 给 定 图 片 的 每 个 像素 中 的 红 、 绿 、 监 
种 颜色 相 加 起 来 ， 并 将 这 些 颜 色 的 总 和 除 以 图 片 的 像素 数量 ， 最 后 把 
除法 计算 的 结果 记录 在 一 个 新 创建 的 三 元 组 里 面 (这 个 三 元 组 使 用 包 
含 3 个 元 素 的 数组 表示 ) 。 


， 程 序 会 使 用 代码 清单 9-12 所 示 的 resize WA, ERA 
E 


代码 清单 9-12 resize 函数 


func resize(in image.Image, newWidth int) image.NRGBA { @ 

bounds := in.Bounds() 

ratio := bounds.Dx()/ newwWidth 

out := image.NewNRGBA(image.Rect(bounds.Min.X/ratio, 
bounds.Min.X/ratio, 
=bounds.Max.X/ratio, bounds.Max.Y/ratio) ) 

for y, j := bounds.Min.Y, bounds.Min.Y; y < bounds.Max.Y; y, j = 


for x, i := bounds.Min.X, bounds.Min.X; x < bounds.Max.X; x, i = 
=xtratio, iti { 


r, g, b, a := in.At(x, y).RGBA() 
out.SetNRGBA(i, j, color.NRGBA{uint8(r>>8), uint8(g>>8), 
uint8(b>>8), 
=uint8(a>>8)}) 
} 
} 


return *out 


} 


@ 将 给 定 图 片 缩放 至 指定 宽度 


代码 清单 9-13 展 示 了 tilesDB KR, i hee A 
片 所 在 的 目录 来 创建 一 个 交 砖 图 片 数 据 库 。 


代码 清单 9-13 tilesDB 函数 


func tilesDB() map[string][3]float64 { ©@ 
fmt.Printin("Start populating tiles db ...") 
db := make(map[string][3]float64) 
files, _ := ioutil.ReadDir("tiles") 
for _, f := range files { 
name := "tiles/" + f.Name() 
file, err := os.Open(name) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 
db[name] = averageColor (img) 
} else { 
fmt.Println("error in populating TILEDB:", err, name) 


} 
} else { 
fmt.Println("cannot open file", name, err) 


i 
file.Close() 


fmt.Printin("Finished populating tiles db.") 
return db 


} 


@ 在 内 存 中 创建 一 个 送 砖 图 片 数据 库 


rene Al A Ua ee — SBR, I SPREE EB, TEI 
三 元 组 (在 程序 中 使 用 包含 3 个 元 素 的 数组 来 表示 ) ° tilesDB 函数 
会 打开 目录 中 的 每 张 图 片 ， 并 根据 这 些 图 片 的 平均 颜色 在 映射 中 创建 
相应 的 记录 。 为 了 寻找 与 目标 图 片 相 匹配 的 瓷砖 图 片 ， 程 序 会 将 
tilesDB 函数 创建 的 瓷砖 图 片 数据 库 以 及 目标 图 片 的 平均 颜色 传 入 
nearest ENR ° 


func nearest(target [3]float64, db *map[string][3]float64) string { 
© 
var filename string 
smallest := 1000000.0 
for k, v := range *db { 
dist := distance(target, v) 
if dist < smallest { 
filename, smallest = k, dist 


} 


} 
delete(*db, filename) 
return filename 
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nearest KASJE EI RAFA EFNA RS BA arr 
均 颜 色 一 一 进行 对 比 ， 而 两 者 欧 几 里 得 距离 最 短 的 那 一 条 记录 ， 就 是 
与 目标 图 片 平 均 颜 色 最 为 接近 的 瓷砖 图 片 。 函 数 会 从 数据 库 中 移 除 被 
选中 的 瓷砖 图 片 ， 并 把 该 图 片 的 名 字 返 回 给 调用 者 。 代 码 清单 9-14 展 示 
了 用 于 计算 两 个 三 元 组 之 间 的 欧 几 里 得 距离 的 distance 函数 。 


代码 清单 9-14 distance 函数 


func distance(p1 [3]float64, p2 [3]float64) float64 { @ 


return math.Sqrt(sq(p2[0]-p1[0]) + sq(p2[1]-p1[1]) + sq(p2[2]- 
tee 


func sq(n float64) float64 { © 
return n * n 


@ 计算 两 点 之 间 的 欧 几 里 得 距离 


@ 计算 给 定数 值 的 平方 


因为 扫 摘 和 载 入 碗 在 图片 数据 库 十 一 项 非常 伦 时 间 的 操作 ， 所 以 
为 了 效率 起 见 ， 比 起 每 次 生成 马赛 殉 图 片 的 时 候 都 重复 一 裔 这 个 操 
作 ， 更 合理 的 做 法 是 只 执行 一 次 这 个 操作 ， 创 建 出 一 个 大 看 图 片 数 据 
库 的 原本 (source) ， 然 后 在 每 次 生成 马赛 克 图 片 的 时 候 都 根据 这 个 原 
本 复制 出 一 个 独立 的 副本 (clone) 。 代 码 清单 9-15 展 示 了 作为 次 砖 图 
片 数据 库 的 原本 而 存在 的 TILEDB 全 局 变量 ，Web 应 用 在 启动 的 时 候 就 
会 创建 并 填充 这 个 变量 。 


代码 清单 9-15 cloneTilesDB 函数 


var TILESDB map[string][3]float64 


func cloneTilesDB() map[string][3]float64 { @ 
db := make(map[string][3]float64) 
for k, v := range TILESDB { 


db[k] = v 


return db 


@ FARER AA eB HME E A 
车 副本 


9.42 ”马赛克 图 片 wWeb 应 用 


在 实现 了 马赛 克 生 成 函数 之 后 ， 我 们 接 下 来 就 可 以 实现 与 之 相对 
应 的 Web 应 用 了 。 代 码 清单 9-16 展 示 了 这 个 应 用 的 具体 代码 ， 这 些 代 码 
WET main. go 文件 中 。 


代码 清单 9-16 ”马赛克 图 片 Web 应 用 


package main 


import ( 
" bytes" 
"encoding/base64" 
UL! fmt UL! 
"html/template" 
" image" 
"image/draw" 
"image/jpeg" 
"net/http" 
UL! OS UL! 
"strconv" 
UL! sync UL! 
UL! time" 


) 


func main() < 
mux := http.NewServeMux ( ) 
files := http.FileServer(http.Dir("public")) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 
mux.HandleFunc("/", upload) 
mux.HandleFunc("/mosaic", mosaic) 


server := &http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 

} 


TILESDB = tilesDB() 
fmt.Println("Mosaic server started.") 
server.ListenAndServe() 


} 


func upload(w http.Responsewriter, r *http.Request) { 
t, _ := template.ParseFiles("upload.htm1") 


t.Execute(w, nil) 


} 


func mosaic(w http.Responsewriter, r *http.Request) { 
tO := time.Now() 


r.ParseMultipartForm(10485760) 


file, _, _ := r.FormFile("image") @ 
defer file.Close() 
tileSize, _ := strconv.Atoi(r.FormValue("tile_size") ) 
Original, _, _ := image.Decode(file) © 
bounds := original.Bounds() 
newimage := image.NewNRGBA(image.Rect(bounds.Min.X, bounds.Min.X, 


bounds.Max.X, bounds.Max.Y)) 


db := cloneTilesDB() ® 


sp := image.Point{0, 0} © 
for y := bounds.Min.Y; y < bounds.Max.Y; y = y + tileSize { © 
for x := bounds.Min.X; x < bounds.Max.X; x = x + tileSize { 
r, g, b, _ := original.At(x, y).RGBA() 
color := [3]floaté64{float64(r), float64(g), float64(b)} 
nearest := nearest(color, &db) 
file, err := os.Open(nearest ) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 
t := resize(img, tileSize) 
tile := t.SubImage(t.Bounds() ) 
tileBounds := image.Rect(x, y, x+tileSize, y+tileSize) 
draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
} else { 


fmt.Println("error:", err, nearest) 


} 
} else { 
fmt.Printin("error:", nearest) 


} 
file.Close() 


} 
} 


buf1 := new(bytes.Buffer) 
jpeg.Encode(bufi, original, nil) © 


OriginalStr := base64.StdEncoding.EncodeToString(bufi.Bytes() ) 


buf2 := new(bytes.Buffer ) 
jpeg.Encode(buf2, newimage, nil) 
mosaic := base64.StdEncoding.EncodeToString(buf2.Bytes() ) 
t1 := time.Now() 
images := map[string]string{ 
"Original": originalStr, 
"mosaic": mosaic, 
"duration": fmt.Sprintf("%v ", t1i.Sub(t0)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 
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@ 对 用 户 上 传 的 目标 图 片 进行 解码 

© 复制 您 矶 图 数据 库 

O ASK AA EEI 
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O 将 图 片 编码 为 JPEG 格式 ， 然 后 通过 base64 字 符 串 将 其 传输 至 浏 


Ws pg 
DL 


mosaic 函数 是 一 个 处 理 器 函数 ， 在 这 个 函数 里 包含 了 用 于 生成 马 
赛 克 图 片 的 主要 逻辑 : 首先 ， 程 序 会 获取 用 户 上 传 的 目标 图 片 ， 并 从 
表单 中 获取 瓷砖 图 片 的 尺寸 接着， 程序 会 对 目标 图 片 进行 解码 ， 并 
创建 出 一 张 全 新 的 、 空 日 的 马赛 充 图 片 ， 之 后 ， 程 序 会 复制 一 份 瓷砖 
图 片 数据 库 ， 并 为 每 张 瓷砖 图 片 设置 起 始点 (source point) ， 而 这 一 
起 始点 将 在 稍 后 的 代码 中 被 jmage/draw 包 所 使 用 。 在 完成 了 上 壕 的 


He Lie Zia, Bebe Bra roe Meee AR 
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对 于 每 张 被 分 割 的 子 图 片 ， 程 序 都 会 把 它 左上 角 的 第 一 个 像素 设 
置 为 该 图 乒 的 平均 颜色 ， 然 后 在 您 矶 图 斤 数 据 库 中 查找 与 该 颜色 最 为 
PUTA Soh Al Ar ° ERRAI RA Za, BOR AA EAS E 
程序 返回 该 图 片 的 文件 名 ， 然 后 程序 就 可 以 打开 这 张 您 砖 图 片 并 将 其 
缩放 至 指定 的 瓷砖 图 片 尺 寸 了 。 在 缩放 操作 执行 完毕 之 后 ， 程 序 就 会 
把 最 终 得 到 的 春 夸 图片 绘制 到 之 前 创建 的 马赛 区 图 片上 。 


在 使 用 上 述 方 法 生成 出 整 张 马赛 克 图 片 之 后 ， 程 序 首 移 会 将 其 编 
码 为 JPEG 格 式 的 图 片 ， 然 后 再 将 图 片 编码 为 base64 格 式 的 字符 串 。 


之 后 ， 程 序 会 将 用 户 上 传 的 目标 图 片 以 及 新 鲜 出 炉 的 马赛 元 图 片 
都 发 送 到 代码 清单 9-17 中 展示 的 results ,html 模板 中 。 正 如 代码 清 
单 中 加 粗 部 分 的 代码 所 示 ， 这 个 模板 会 通过 数据 URL 以 及 骨 入 Web 页 面 
中 的 base64 字 符 串 来 显示 被 传 入 的 两 张 图 片 。 注 意 ， 这 里 使 用 的 数据 
URL 跟 一 般 URL 的 作用 并 不 相同 ， 前 者 用 于 包含 给 定 的 数据 ， 而 后 者 
则 用 于 指 癌 其 他 资源 。 


代码 清单 9-17 ”用 于 展示 马赛 元 图 片 生 成 结果 的 模板 


< !DOCTYPE html> 


< meta http-equiv="Content-Type" content="text/html; 
charset=utf-8"> 
< title>Mosaic< /title> 
< /head> 
< body> 
< div class='container'> 


< div class="col-md-6"> 


< img src="data:image/jpg;base64,{{ .original }}" 
width="100%"> 


< div class="lead">Original< /div> 
< /div> 
< div class="col-md-6"> 


< img src="data:image/jpg;base64,{{ .mosaic }}" 
width="100%"> 


< div class="lead">Mosaic - {{ .duration }} 


< /div> 
< /div> 
< div class="col-md-12 center"> 
< a class="btn btn-lg btn-info" href="/">Go Back< /a> 
< /div> 
< /div> 
< br> 
< /body> 
< /html> 


假设 上 述 程 序 位 于 mosaic 目录 当中 ， 那 么 我 们 可 以 在 构建 该 程序 
之 后 ， 通 过 执行 以 下 命令 ， 以 只 使 用 一 个 CPU 的 方式 去 运行 它 ， 并 得 
到 图 9-5 所 示 的 结果 : 


GOMAXPROCS=1 ./mosaic 
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图 9-5 ”基本 的 马赛 克 图 片 生成 Web 应 用 


在 完成 了 基本 的 马赛 克 图 片 生 成 Web 应 用 之 后 ， 我 们 接 下 来 要 考虑 
的 就 是 如 何 把 这 个 应 用 改造 成 相应 的 并 发 版 本 了 。 


943 ”并 发 版 马赛 克 图 片 生 成 Web 应 用 


并 发 的 一 个 常见 用 途 是 提高 性 能 。 上 一 节 展 示 的 Web 应 用 在 为 151 
KB 大 小 的 JPEG 图 片 创建 马赛 元 图 片 时 需要 耗费 2.25 s， 它 的 性 能 并 不 
值得 称道 ， 但 我 们 可 以 通过 并 发 来 提高 它 的 性 能 。 具 体 来 说 ， 我 们 将 
使 用 以 下 算法 来 构建 一 个 并 发 版 本 的 马赛 克 图 片 生成 Web 应 用 : 


(1) 将 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 ; 


(2) TRS RY NEAT 4 FR Ar ET SS BE eh 
(3) 将 处 理 完 的 4 张 子 图 片 重新 合并 为 1 张 马赛 克 图 片 。 


图 9-6 以 图 示 的 方式 描述 了 上 进步 又。 


2. 分 别 对 4 张 子 图 片 
进行 马赛 克 处 理 。 


1. 将 目标 图 片 


3.4 完 的 4 
分 割 为 4 等 份 。 将 处 理 完 的 4 张 子 图 片 


合并 为 1 张 马赛 克 图 片 。 


图 9-6 能够 更 快 地 生成 马赛 克 图 片 的 并 发 算法 


需要 注意 的 是 ， 这 个 算法 并 不 是 提高 性 能 的 唯一 方法 ， 也 不 是 实 
现 并 发 版 本 的 唯一 方法 ， 但 它 是 一 个 相对 来 说 比较 简单 直接 的 方法 。 
为 了 实现 这 个 并 发 算法 ， 我 们 需要 对 mosaic 处 理 器 函数 做 一 些 修 


改 。 之 前 展示 的 程序 只 有 mosaic 这 一 个 创建 马赛 克 图 片 的 处 理 器 男 
数 ， 但 是 对 并 发 版 的 Web 应 用 来 说 ， 我 们 需要 从 mosaic 函数 中 分 离 出 


cut 和 combine 这 两 个 独立 的 函数 ， 然 后 再 在 mosaic 函数 中 调用 它 
们 。 代 码 清单 9-18 展 示 了 修改 后 的 mosaic ay ° 


代码 清单 9-18 并 发 版 的 mosaic 处 理 器 函数 


func mosaic(w http.Responsewriter, r *http.Request) { 
tO := time.Now() 
r.ParseMultipartForm(10485760) // max body in memory is 10MB 
file, _, _ := r.FormFile("image") 
defer file.Close() 
tileSize, _ := strconv.Atoi(r.FormValue("tile_size") ) 
Original, _, _ := image.Decode(file) 
bounds := original.Bounds() 
db := cloneTilesDB() 


c1 := cut(original, &db, tileSize, bounds.Min.X, bounds.Min.yY, 

=bounds.Max.X/2, bounds.Max.Y/2)@ 

c2 := cut(original, &db, tileSize, bounds.Max.X/2, bounds.Min.Y, 

=bounds.Max.X, bounds.Max.Y/2)@ 

c3 := cut(original, &db, tileSize, bounds.Min.X, bounds.Max.Y/2, 

=bounds.Max.X/2, bounds.Max.Y)@® 

c4 := cut(original, &db, tileSize, bounds.Max.X/2, 
bounds.Max.Y/2, 

=bounds.Max.X, bounds.Max.Y)@ 

c := combine(bounds, c1, c2, c3, c4) @ 


buf1 := new(bytes.Buffer) 
jpeg.Encode(buf1, original, nil) 
originalStr := base64.StdEncoding.EncodeToString(buf1.Bytes()) 


t1 := time.Now() 
images := map[string]string{ 
"Original": originalStr, 
"mosaic": <-C, 
"duration": fmt.Sprintf("%v ", t1i.Sub(t0)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 


} 


@ 以 书 形 散 开 方 式 分 割 图 片 以 便 单 独 进行 处 理 


@ 以 书 形 聚拢 方式 将 多 个 子 图 片 合并 成 一 个 完整 的 图 片 


cut 函数 会 以 证 形 散 开 (fan-out) 模式 将 目标 图 片 分 割 为 多 个 子 
图 片 ， 如 图 9-7 所 示 。 


图 9-7 将 目标 图 片 分 割 为 4 等 份 


用 户 上 传 的 目标 图 片 将 被 分 割 为 4 等 份 以 便 独立 处 理 。 注 意 ， 在 
mosaic 呈 数 里 ， 程 序 调用 的 都 是 普通 函数 而 不 是 goroutine， 这 是 因为 
程序 的 并 发 部 分 存在 于 被 调用 函数 的 内 部 : cut 函数 会 在 内 部 以 
goroutine 方 式 执行 一 个 匿名 函数 ， 而 这 个 匿名 函数 则 会 返回 一 个 通道 作 
为 结果 。 


需要 注意 的 是 ， 因 为 我 们 正在 演 试 将 一 个 程序 转换 为 相应 的 并 发 
版 本 ， 而 并 发 程序 通常 都 需要 同时 运行 多 个 goroutine， 所 以 如 果 程 序 需 
要 在 这 些 goroutine 之 间 共 享 一 些 资 源 ， 那 么 针对 这 些 资源 的 修改 将 有 可 
能 会 导致 范 争 条 件 出 现 。 


如 果 一 个 程序 在 执行 时 依赖 于 特定 的 顺序 或 时 序 ， 但 是 又 无 法 保证 这 种 顺序 或 时 序 ， 此 
时 就 会 存在 竞争 条 件 (race condition) 。 竞 争 条 件 的 存在 将 导致 程序 的 行为 变 得 飘忽 不 定 而 
且 难 以 预测 。 | 


竞争 条 件 通常 出 现在 那些 需要 修改 共享 资源 的 并 发 程序 当中 。 当 有 两 个 或 多 个 进程 或 线 
程 同时 去 修改 一 项 共享 资源 时 ， 最 先 访问 资源 的 那个 进程/ 线程 将 得 到 预期 的 结果 ， 而 其 他 进 
程 /线程 则 不 然 。 最 终 ， 因 为 程序 无 法 判断 哪个 进程 /线程 最 先 访 问 了 资源 ， 所 以 它 将 无 法 产 
生 一 致 的 行为 。 | 


虽然 竞争 条 件 一 般 都 不 太 好 发 现 ， 但 修复 个 已 判明 的 竞争 条 件 通常 来 说 并 不 是 一 件 难 


本 节 介 绍 的 马赛 克 图 片 生成 Web 应 用 同样 也 拥有 共享 资源 ， 用 户 在 
将 目标 图 片上 传 至 Web 应 用 之 后 ，nearest 函数 就 会 从 次 砖 图 片 数 据 
库 中 寻找 与 之 最 为 匹配 的 瓷砖 图 片 ， 并 从 数据 库 中 移 除 被 选中 的 图 片 
以 防 相同 的 图 片 重复 出 现 。 这 就 意味 着 ， 如 有 果 多 个 cut 函数 中 的 


goroutine FITERE] SRA AEA ELAR, Mare he 
PRIF ° 


ASTER EPR, BATA APPA AR (mutual 
exclusion, fal f\“mutex ” 的 技术 ， 该 技术 可 以 将 同一 时 间 内 访问 临界 
区 (critical section) 的 进程 数量 限制 为 一 个 。 对 马赛 克 图 片 生成 Web 应 
用 来 说 ， 我 们 需要 在 nearest 函数 中 实现 互 不 ， 以 此 来 保证 同一 时 间 
内 只 能 有 一 个 goroutine 对 瓷砖 图 片 数 据 库 进 行 修改 。 


为 了 满足 这 一 点 ， 程 序 需要 用 到 Go 标准 库 sync 包 中 的 Mutex 结 
构 。 首 先 要 做 的 是 ae LER), FPA PERI Ae Al 
片 数 据 库 以 及 mutex 标志 ， 有 具体 如 代码 清单 9-19 所 示 “。 


代码 清单 9-19 DB 结构 


type DB struct { 
mutex *sync.Mutex 


store map[string][3]float64 


接着 ， 如 代码 清单 9-20 所 示 ， 将 nearest 函数 修改 为 DB 结构 的 一 
Ae R 


代码 清单 9-20 nearest 方法 


func (db *DB) nearest(target [3]float64) string { 
var filename string 
db.mutex.Lock() ©@ 
smallest := 1000000.0 
for k, v := range db.store { 
dist := distance(target, v) 
if dist < smallest { 


filename, smallest = k, dist 


} 


delete(db.store, filename) 
db.mutex.Unlock() @ 
return filename 


IHW Ei E mutex 标志 


通过 解锁 移 除 mutex 标志 


多 个 


需要 注意 的 是 ， 因 为 在 从 数据 库 里 移 除 被 选中 的 图 片 之 前 ， 多 
goroutine 还 是 有 可 能 会 把 相同 的 父 砖 图 片 设置 为 最 佳 的 匹配 结 有 末 ， 所 以 
只 锁 住 delete 函数 是 无 法 移 除 苋 搜 条 件 的 ， 因 此 修改 后 的 nearest 

函数 将 把 寻找 最 佳 匹配 瓷砖 图 片 的 整个 区 域 (section) 都 锁 住 。 


代码 清单 9-21 展 示 了 cut 函数 的 具体 代码 。 


代码 清单 9-21 cut 函数 


x1, y1, x2, y2 


func cut(original image.Image, db *DB, tileSize, 
int) <-chan 
image.Image { 0 
c := make(chan image.Image) @ 
sp := image.Point{0, 0} 
go func() {© 
newimage := image.NewNRGBA(image.Rect(x1, y1, x2, y2)) 
for y := y1; y < y2; y = y + tileSize { 


for x := x1; x < x2; x = x + tileSize { 
r, g, b, _ := original.At(x, y).RGBA() 
color := [3]float64{float64(r), float64(g), float64(b)} 
nearest := db.nearest(color) © 
file, err := os.Open(nearest) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 


t := resize(img, tileSize) 


tile := t.SubImage(t.Bounds() ) 


tileBounds := image.Rect(x, y, xttileSize, y+tileSize) 
draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
} else { 


fmt.Printin("error:", err) 


} 
} else { 
fmt.Printin("error:", nearest) 


} 
file.Close() 


c <- newimage.SubImage(newimage.Rect ) 


}() 


return c 


} 


© 把 指向 DB 结构 的 引用 传递 给 DB 结构 ， 而 不 是 仅仅 传 入 一 个 映 


zi 
@ 这 个 通道 将 作为 函数 的 执行 结果 返回 给 调用 者 


© 创建 匿名 的 goroutine 


© 调用 DB 结构 的 nearest FK RR P MAAS ER AT 


并 发 版 的 马赛 元 图 片 生 成 Web 应 用 跟 原 来 的 非 并 发 版 本 拥有 相同 的 
逻辑 : 它 首 先 在 cut 函数 里 创建 一 个 通道 ， 并 启动 一 个 匿名 goroutine 来 
计算 将 要 被 发 送 至 该 通道 的 马赛 克 处 理 结果 ， 接 着 再 把 这 个 通道 返回 
给 cut NALA VA Ae 2 EEK, cut 函数 创建 的 通道 就 会 立即 返回 
给 mosaic 处 理 器 函数 ， 而 通道 对 应 的 马赛 元 于 图 片 则 会 在 处 理 完 毕 之 
后 被 发 送 至 通道 。 另 外 需要 注意 的 是 ， 虽 然 cut 画 数 创建 的 是 一 个 双 
向 通道 ， 但 是 如 有 末 需 要 ， 我 们 也 可 以 在 返回 这 个 通道 之 前 ， 通 过 类 型 
转换 (typecast) 将 它 转换 成 一 个 只 能 接收 信息 的 单 向 通道 


在 把 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 并 将 它们 分 别 转换 为 马赛 克 
图 片 的 一 部 分 之 后 ， 程 序 接 下 来 就 会 调用 代码 清单 9-22 所 示 的 
combine 画 数 ， 通 过 扇形 聚拢 (fan-in) 模式 ， 将 4 张 子 图 片 重新 合并 
成 1 张 完 整 的 马赛 区 图片 。 


代码 清单 9-22 combine 函数 


func combine(r image.Rectangle, c1, c2, c3, c4 <-chan image.Image) 
<-chan string { 
c := make(chan string) ® 


go func() { @ 
var wg sync.WaitGroup © 
img:= image.NewNRGBA(r ) 
copy := func(dst draw.Image, r image.Rectangle, 
src image.Image, sp image.Point) { 
draw.Draw(dst, r, src, sp, draw.Src) 
wg.Done() @ 


wg.Add(4) © 
var si, s2, s3, s4 image.Image 
var oki, ok2, ok3, ok4 bool 
for { © 
select { @ 
case si, oki = <-c1: 
go copy(img, s1.Bounds(), s1, 
image.Point{r.Min.X, r.Min.Y}) 
case s2, ok2 = <-c2: 
go copy(img, s2.Bounds(), s2, 
image.Point{r.Max.X / 2, r.Min.Y}) 
case s3, Ok3 = <-c3: 
go copy(img, s3.Bounds(), s3, 
image.Point{r.Min.X, r.Max.Y/2}) 
case s4, ok4 = <-c4: 
go copy(img, s4.Bounds(), s4, 
image.Point{r.Max.X / 2, r.Max.Y / 2}) 


if (oki && ok2 && ok3 && ok4) { © 
break 
} 
} 


wg.Wait() © 
buf2 := new(bytes.Buffer ) 
jpeg.Encode(buf2, img, nil) 
c <- base64.StdEncoding.EncodeToString(buf2.Bytes()) 
}() 
return c 


} 


@ 创建 一 个 匿名 goroutine 

© 使 用 等 待 组 去 同步 各 个 子 图 片 的 复制 操作 

O 每 复制 完 一 张 子 图 片 ， 就 对 计数 器 执行 一 次 减 一 操作 
O 把 等 待 组 计数 器 的 值 设 置 为 4 


O 在 一 个 无 限 循 环 里 面 等 每 所 有 复制 操作 完成 


O 当 所 有 通道 都 被 关闭 之 后 ， 跳 出 循环 
© 阻塞 直到 所 有 子 图 片 的 复制 操作 都 执行 完毕 为 止 


ER cut 函数 一 样 ， 合 并 多 张 子 独 片 的 主要 逻辑 也 放 到 了 匿名 
goroutine 中 ， 并 且 这 些 goroutine 同 样 会 创建 并 返回 一 个 只 能 执行 接收 操 
作 的 通道 作为 结果 。 这 样 一 来 ， 程 序 就 可 以 在 编码 目标 图 片 的 同时 ， 
对 马赛 克 图 片 的 4 个 部 分 进行 合并 。 


在 combine 函数 创建 的 匿名 goroutine 里 ， 程 序 会 构建 男 一 个 匿名 

函数 ， 并 将 其 赋值 给 变量 copy 。copy 函数 之 后 同样 会 以 goroutine 方 
式 运 行 ， 并 将 给 定 的 马赛 克 子 图 片 复 制 到 最 终 的 马赛 克 图 片 中 。 与 此 
同时 ， 因 为 程序 无 法 得 知 以 goroutine 方 式 运行 的 copy 画 数 将 于 何 时 结 
束 ， 所 以 它 使 用 了 等 待 组 来 同步 这 些 复 制 操 作 。 程 序 首先 创建 一 个 
WaitGroup 变量 wg ， 并 使 用 Add 方法 将 计数 器 的 值 设置 为 4。 之 
后 ， 每 当 一 个 复制 操作 执行 完毕 的 时 候 ，copy 函数 都 会 调用 Done 方 
法 ， 把 等 待 组 计数 句 的 值 减 1°。 最 后 ， 程 序 把 一 个 Wait 方法 调用 放 在 
了 最 终生 成 的 马赛 克 图 片 的 编码 操作 之 前 ， 以 此 来 保证 程序 只 会 在 所 
有 复制 goroutine 都 已 执行 完毕 ， 并 且 程 序 已 经 拥有 了 完整 的 最 终 马 赛 克 
图 片 之 后 ， 才 会 开始 对 图 片 进 行 编码 。 


一 个 需要 注意 的 地 方 是 ，combine 函数 接受 的 输入 包含 了 4 个 来 
Scut 函数 的 通道 ， 这 些 通道 包含 了 马赛 区 图 片 的 各 个 组 成 部 分 ， 并 
且 程 序 不 知道 这 些 部 分 何 时 才 会 通过 通道 传输 过 来 。 虽 然 程 序 可 以 按 
顺序 一 个 接 一 个 从 这 些 通道 里 接收 信息 ， 但 这 种 做 法 并 不 符合 并 发 程 
序 的 风格 。 为 此 ， 程 序 使 用 了 select 方法 ， 以 先 到 先 服务 的 方式 来 接 
收 这 些 通道 发 送 的 信息 。 


这 样 做 的 结果 是 ， 程 序 会 在 一 个 无 限 循 环 里 面 进行 迭代 ， 并 且 每 
TIS RMSE H select 去 获取 其 中 一 个 已 就 绪 通 道 传送 的 子 图 片 (如 
果 同 时 有 多 个 子 图 片 可 用 ， 那 么 Go 将 随机 选择 其 中 一 个 ) ， 然 后 以 
goroutine 方 式 执行 copy 函数 ， 将 接收 到 的 子 图 片 复制 到 最 终生 成 的 马 
赛区 图片 当 中 。 因 为 程序 使 用 了 多 值 格式 (multivalue format) 来 接收 
通道 的 返回 值 ， 而 通道 的 第 二 个 返回 值 〈“ 即 ok1、ok2 、ok3 和 ok4 


) 可 以 说 明 程 序 是 否 已 经 成 功 地 接收 了 各 个 通道 传送 的 子 图 片 ， 所 以 
在 无 限 循 环 的 末尾 ， 程 序 会 通过 检测 这 些 返 回 值 来 决定 是 否 跳 出 循 
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因为 程序 在 接收 到 所 有 子 图 片 之 后 ， 还 需要 在 4 个 goroutine 里 分 别 
复制 这 些 子 图 片 ， 而 这 些 复制 操作 的 完成 时 间 是 不 确定 的 。 为 了 解决 
这 个 问题 ， 程 序 会 调用 之 前 定义 的 等 待 组 变量 wg 的 Wait 方法 ， 对 最 
终生 成 的 马赛 元 图 片 的 编码 操作 进行 阻塞 ， 直 到 上 述 复 制 操作 全 部 执 
行 完 毕 为 止 。 


现在 ， 我 们 终于 拥有 了 一 个 并 发 版 的 马赛 克 图 片 生成 Web 应 用 ， 接 
下 来 是 时 候 运 行 一 下 它 了 。 首 先 ， 假 设 程序 位 于 
mosaic_concurrent 目 孙 当中 ， 那 么 在 使 用 go build 构建 该 程序 
之 后 ， 我 们 可 以 通过 执行 以 下 命令 ， 使 用 单个 CPU 去 运行 它 : 


GOMAXPROCS=1 ./mosaic concurrent 


如 琳 一 切 正常 ， 将 会 看 到 图 9-8 所 示 的 结果 ， 生 成 这 个 结 末 时 使 用 
的 目标 图 片 以 及 组 砖 图 片 跟 之 前 运行 非 并 发 版 本 时 是 完全 一 样 的 。 


由 于 并 发 版 程序 在 将 4 张 子 图 片 合并 成 1 张 完整 的 马赛 克 图 片 的 时 
候 ， 没 有 对 子 图 片 的 毛 边 进行 平 消 处 理 ， 所 以 如 琳 你 仔细 对 比 束 会 发 
现 ， 这 次 生成 的 马赛 区 图 片 跟 之 前 非 并 发 版 本 生成 的 马赛 区 图 片 是 有 
一 点 细微 区 别 的 (从 彩色 显示 的 电子 书 上 会 更 为 明显 地 看 出 这 一 
点 ) 。 尽 管 生成 的 马赛 克 图 片 有 些 细微 的 不 同 ， 但 并 发 版 程序 的 性 能 
提升 是 非常 明显 的 一 一 非 并 发 版 的 马赛 克 图 片 生成 Web 应 用 处 理 相同 的 


目标 图 片 耗费 了 2.25 s， 而 并 发 版 本 只 耗 线 了 646 hs， 后 者 的 性 能 比 前 
者 提高 了 几乎 有 4 倍 之 多 。 
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图 9-8 ”并 发 版 的 马赛 克 照 片 生成 Web 应 用 


初 看 上 去 ， 我 们 所 做 的 似乎 只 是 将 一 个 函数 分 割 成 4 个 独立 运行 的 
goroutine， 以 此 来 实现 一 个 并 发 版 本 的 Web 程 序 ， 但 如 果 我 们 再 进 一 
步 ， 以 并 行 的 方式 去 运行 这 个 程序 ， 结 果 又 会 如 何 呢 ? 


别 筷 了 ， 在 前 面 的 程序 中 ， 我 们 不 仅 将 一 个 运行 非常 耗 时 的 处 理 
人 右 函数 分 割 成 了 几 个 独立 运行 的 cut 函数 goroutine， 而 且 我 们 还 在 
combine 函数 里 使 用 多 个 goroutine 来 独立 地 组 合 马赛 克 图 片 的 各 个 部 
分 。 每 当 一 个 cut KAERT CN LEZ, ERA RAEN ARE 


送 给 与 之 对 应 的 combine 了 芳 数 ， 而 后 者 则 会 将 这 一 结 末 复制 到 最 终生 
成 的 马赛 苑 图片 当中 。 


除 此 之 外 ， 别 筷 了 ， 在 前 面 运行 非 并 发 版 本 和 并 发 版 本 的 马赛 克 
图 片 生成 Web 应 用 时 ， 我 们 都 只 使 用 了 一 个 CPU。 正 如 之 前 所 说 ， 并 发 
不 是 并 行 一 一 本 市 前 面 的 内 容 已 经 展示 了 如 何 将 一 个 简单 的 算法 分 解 
为 相应 的 并 发 版 本 ， 其 中 不 涉及 任何 并 行 计算 : 尽管 这 些 goroutine 能 够 
以 并 发 方式 运行 ， 但 是 因为 只 有 一 个 CPU 可 用 ， 所 以 这 些 goroutine 实 际 
上 并 没有 以 并 行 的 方式 运行 。 


为 了 让 故事 有 一 个 圆满 的 结局 ， 现 在 我 们 可 以 通过 执行 以 下 命 
令 ， 以 并 行 的 方式 ， 在 多 个 CPU 以 及 进程 上 运行 并 发 版 的 马赛 区 图 片 
生成 web 应用: 


./mosaic_concurrent 
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正如 结果 中 打印 的 时 间 所 示 ， 并 行 运行 的 并 发 程序 比 单纯 的 并 发 
程序 又 获得 了 大 约 3 倍 的 性 能 提升 ， 具 体 时 间 从 原来 的 646 ps 减少 到 了 
现在 的 216 ps! 如 果 我 们 把 这 一 结果 跟 最 初 的 非 并 发 版 本 所 需 的 2.25 s 
相 比 ， 那 么 新 程序 的 性 能 提升 足 有 10 倍 之 多 。 


对 马赛 克 图 片 生成 Web 应 用 来 说 ， 非 并 发 版 本 跟 并 发 版 本 使 用 的 图 
厂 处 理 算法 是 完全 相同 的 。 实 际 上 ， 两 个 版 本 的 mosaic .go 源码 文件 
差别 并 不 大 ， 它 们 之 间 的 主要 区 别 在 于 是 否 使 用 了 并 发 特性 ， 这 是 提 
高 程序 性 能 的 关键 。 


@ee < 加 localhost > ry 4 


Original — 


图 9-9 ”使 用 8 个 CPU 运 行 并 发 版 的 马赛 克 图 片 生成 Web 应 用 


完成 了 马赛 克 图 片 生成 Web 应 用 之 后 ， 在 接 下 来 的 一 章 ， 我 们 要 考 
虑 的 就 是 如 何 部 署 Web 应 用 和 Web 服 务 了 。 


9.5 小结 


。 Go Web 服 务 器 本 身 是 并 发 的 ， 服 务 器 会 把 接收 到 的 每 条 请 求 都 放 
到 独立 的 goroutine 里 运行 。 

。 并 发 和 并 行 是 两 个 相辅相成 的 概念 ， 但 它们 并 不 相同 。 并 发 指 的 
是 两 个 或 多 个 任务 在 同一 时 间 段 内 局 动 、 运 行 和 结束 ， 并 且 这 些 
任务 可 能 会 彼此 互动 ， 而 并 行 则 是 单纯 地 同时 运行 多 个 任务 。 

。 G0 通过 goroutine 和 通道 这 两 个 重要 的 特性 直接 支持 并 发 ， 但 Go 并 
不 直接 文 持 并 行 。 


goroutine 用 于 编写 并 发 程序 ， 而 通道 则 用 于 为 不 同 的 goroutine 之 间 
提供 通信 和 功能。 

无 缓冲 通道 都 是 同步 鸭 ， 芝 试问 一 个 已 经 包含 数据 的 无 缓冲 通道 
推 入 新 的 数据 将 被 阻塞 ， 但是， 有 缓冲 通道 在 被 填 满 之 前 都 是 异 
步 的 。 

select 语句 可 以 以 先 到 先 服 务 的 方式 ， 从 多 个 通道 里 选 出 一 个 已 
经 准备 好 执行 接收 操作 的 通道 。 

WaitGroup 同样 可 以 用 于 对 多 个 通道 进行 同步 。 

并 发 程序 的 性 能 一 般 都 会 比 相应 的 非 并 发 程序 要 高 ， 而 具体 提升 
多 少 则 取决 于 所 使 用 的 算法 〈 即 使 在 只 使 用 一 个 CPU 的 情况 下 ， 
也 是 如 此 ) 。 

在 条 件 允 许 的 情况 下 ， 并 发 的 Web 应 用 将 目 动 地 获得 并 行 带 来 的 优 
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[1] 原 书 说 Go 1.4 goroutine 的 启动 栈 大 小 为 8KB， 但 根据 资料 ， 这 个 栈 
的 大 小 应 该 是 2KB 才 对 ， 所 以 在 译文 里 面 进行 了 修正 。 (资料 链接 : 
https://golang.org/doc/go1.4#runtime ° ) 一 一 译 者 注 


第 10 章 Go 的 部 署 


本 章 主要 内 容 


。 把 Go Web 应 用 部 团 到 独立 服务 器 
。 把 Go Web 应 用 部 署 到 云端 
。 把 Go WebM Hi ab F| Docker 45 


在 学 习 了 如 何 使 用 Go 开发 Web 应 用 之 后 ， 接 下 来 要 考虑 的 目 然 束 
征 如 何 部 车 这 些 应 用 了 “。Web 应 用 跟 其 他 类 型 的 应 用 在 部 嗜 方式 上 存在 
着 非常 大 的 不 同 。 比 如 ， 果 面 应 用 和 移动 应 用 融 是 部 车 在 智能 手机 、 
平板 电脑 、 手 提 电 脑 等 终端 用 户 的 设备 上 ， 而 web 应 用 则 年 部 署 在 服务 
吉 上 ， 然 后 通过 终端 用 户 设 备 上 的 浏览 锅 等 客户 咒 对 其 进行 访问 。 


因为 Go 的 可 执行 程序 都 会 被 编译 为 单独 的 二 进 制 文件 ， 所 以 部 署 
Go Web 应 用 程序 在 某 种 程度 上 可 以 说 是 非常 简单 的 。 除 此 之 外 ，Go 还 
可 以 编译 出 不 需要 引用 任何 外 部 库 的 静态 链接 二 进 制 文件 ， 这 种 文件 
可 以 作为 独立 的 可 执行 文件 存在 。 不 过 一 个 完整 的 Web 应 用 通常 不 会 只 
包含 一 个 可 执行 文件 ， 它 一 般 还 会 包含 一 些 模板 文件 ， 以 及 诸如 
JavaScript ` KF ` ERE (style sheet) 这 样 的 静态 文件 。 本 章 将 会 介 
绍 几 种 把 Go Web 应 用 部 署 到 互联 网 的 方法 ， 其 中 大 部 分 方法 都 是 通过 
云 供应 商 (cloud provider) 实现 的 。 本 章 将 要 介绍 的 部 署 方法 包括 : 


。 在 一 个 完全 由 用 户 本 人 控制 的 物理 或 虚拟 的 服务 占 上 实施 部 署 ， 
本 章 正文 将 使 用 IaaS 供 应 商 Digital Ocean 的 服务 器 作为 例子 ; 


。 在 云 PaaS 供 应 商 Heroku 上 实施 部 署 ; 

。 在 另 一 家 云 PaaS 供 应 商 Google App Engine (GAE) 上 实施 部 署 ; 

。 将 应 用 Docker 化 (dockerized) 为 容器 ， 然 后 将 其 部 署 到 本 地 
Docker 服 务 器 以 及 Digital Ocean 的 虚拟 机 上 。 


和 计算 机 使 用 权限 的 模型 ， 这 种 模型 可 以 提供 一 个 


云 计 算 ， 简称 “ 云 ”"， 是 一 种 获取 网 
由 服务 器 、 存 储 空间 、 网 络 以 及 其 他 可 共享 资源 组 成 的 共享 资源 池 ， 从 而 使 这 些 资源 的 用 户 


可 以 避免 不 必要 的 前 期 投入 ， 也 可 以 让 这 些 资源 的 供应 商 更 加 高 效 地 利用 这 些 资 源 为 更 多 的 
户 提供 服务 。 云 计算 在 最 近 这 些 年 吸引 了 非常 多 的 关注 ， 时 至 今日 ， 包 括 Amazon、Google 
和 Facebook 在 内 的 绝 大 部 分 基础 设施 以 及 服务 供应 商都 使 用 这 种 模型 作为 他 们 的 标准 收费 模 


型 。 


需要 注意 的 是 ， 部 署 一 个 Web 应 用 通常 会 有 很 多 种 不 同 的 方法 可 
选 ， 比 如 ， 本 章 介 绍 的 几 种 部 署 方法 之 间 束 存在 着 非常 多 的 不 同 之 
处 。 还 有 一 点 要 说 明 的 是 ， 本 章 介绍 的 部 署 方法 关注 的 是 如 何 部 署 个 
人 的 Web 应 用 ， 真 正 生 产 环境 下 的 部 署 通 利 会 包 舍 运行 测试 套件 、 实 施 
持续 集成 以 及 调整 服务 紫 等 一 系列 额外 的 任务 ， 具 体 过 程 会 比 这 里 介 


绍 的 要 复杂 得 多 。 


本 章 虽 然 介绍 了 很 多 概念 和 工具 ， 但 由 于 这 些 概念 和 工具 每 个 都 
值得 用 整整 一 本 书 的 篇 幅 去 介绍 ， 所 以 本 章 并 没有 试图 全 面 讲 解 这些 
技术 和 服务 。 相 反 ， 本 章 只 会 关注 这 些 技术 的 一 部 分 知识 ， 读 者 可 以 
把 这 些 知识 看 作 是 学 习 相关 技术 的 起 上 把。 


本 章 展 示 的 部 署 例子 将 会 用 到 7.6 节 介绍 过 的 简单 Web 服 务 ， 并 在 
条 件 允 许 的 情况 下 使 用 PostgreSQL (因为 GAE 不 支持 PostgreSQL， 所 以 


在 介绍 GAE 的 部 署 方法 时 ， 本 章 将 使 用 基于 MySQL 的 Google Cloud 
SQL) 。 与 此 同时 ， 本 章 还 会 假设 独立 的 数据 库 服 务 器 上 已 经 预先 设 
置 好 了 数据 库 的 相关 设置 ， 所 以 本 章 将 不 会 介绍 具体 的 数据 库 设置 方 
法 ， 有 需要 的 读者 可 以 通过 复习 2.6 节 来 获得 一 个 简短 的 设置 介绍 。 


10.1 将 应 用 部 署 到 独立 的 服务 器 


让 我 们 从 最 简单 的 部 署 方 法 开始 一 一 创建 一 个 可 执行 的 二 进 制 文 
件 ， 并 将 它 放 到 互联 网 的 某 个 服务 絮 上 运行 ， 这 个 服务 如 可 以 是 物理 
存在 的 ， 也 可 以 是 由 Amazon Web Services (AWS) 或 者 Digital Ocean 等 
供应 商 创 建 的 虚拟 机 (VM) 。 在 本 市 中 ， 我 们 将 要 学 习 如 何在 运行 着 
Ubuntu Server 14.04 系 统 的 服务 器 上 部 署 Go Web 应 用 。 


r TaaS ~ PaaS 和 SaaS 生生 | 


云 计 算 供应 商都 会 通过 不 同 的 模型 来 为 用 户 提供 服务 。 美 国 国家 标准 技术 研究 所 | 
(National Institute of Standards and Technology, US Department of Commerce, NIST) 定义 了 | 
和 当今 广 为 使 用 的 3 种 服务 模型 ， 分 别 是 基础 设施 即 服务 (Infrastructure-as-a-Service, IaaS) , 


平台 即 服 务 (Platform-as-a- Service, PaaS) 和 软件 即 服务 (Software-as-a-Service, SaaS) ° 


IaaS 是 这 3 种 模型 中 最 为 基本 的 一 种 ， 使 用 这 种 模型 的 供应 商 将 向 他 们 的 和 户 提供 包括 计 

算 、 存 储 以 及 网 络 在 内 的 基本 计算 能 力 。 提 供 IaaS 服 务 的 例子 有 AWS 的 弹性 云 计 算 服 务 
(Elastic Cloud Computing Service, EC2) 、Google 公 司 的 Compute Engine (计算 引 警 ) 以 及 | 

| Digital Ocean 的 Droplets ° : 


使 用 PaaS 模 型 的 供应 商会 让 用 户 通 过 他 们 提供 的 工具 ， 将 应 用 部 署 到 云端 的 基础 设施 之 : 
1 上。 提供 Paas 服 务 的 例子 有 Heroku、AWS 的 Elastic Beanstalk 以 及 Google 公 司 的 App Engine ° : 


使 用 SaaS 模 型 的 供应 商会 向 用 户 提供 应 用 服务 。 尽 管 消费 者 当今 使 用 的 绝 大 多 数 服务 都 | 
| 可 以 看 作 是 SaaS 服 务 ， 但 是 在 本 书 的 语 境 中 ， 我 们 只 会 把 Heroku 的 Postgres 数据 库 服务 
| (Postgres database service， 它 提供 的 是 基于 云 的 Postgres 服 务 ) 、AWS 的 Relational Database 


Service (KRAER, RDS) 以 及 Google 公 司 的 Cloud SQL (ZSQL) 这 样 的 服务 看 作 是 
SaaS 服 务 。 i 


在 本 章 中 ， 我 们 将 学 习 如 何 利用 IaaSs 和 PaaSs 供 应 商 来 部 署 Goweb 应 用 。 


本 书 第 7 章 介绍 过 的 简单 Web 服 务 由 代码 清单 10-1 中 的 data.go 和 
代码 清单 10-2 中 的 server .go 这 两 个 文件 组 成 ， 前 痢 包公 了 所 有 指 癌 
数据 库 的 连接 和 所 有 对 数据 库 进 行 读 写 的 画 数 ， 而 后 着 则 包含 了 main 
AA WebAR A Hy At Mh Ee Be 。 


lm 


代码 清 


£10-1 ffÆdata.go 访问 数据 库 


package main 


import ( 

"database/sql" 

_ "github.com/1ib/pq" 
) 


var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
=sslmode=disable" ) 
if err != nil { 
panic(err) 


} 


func retrieve(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id 
=$1", id).Scan(&post.Id, &post.Content, &post.Author) 
return 


} 


func (post *Post) create() (err error) { 
statement := "insert into posts (content, author) values ($1, $2) 
=returning id" 


stmt, err := Db.Prepare(statement) 
if err != nil { 

return 
} 


defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 

} 


func (post *Post) update() (err error) { 

_, err = Db.Exec("update posts set content = $2, author = $3 
where id = 

=$1", post.Id, post.Content, post.Author) 

return 


func (post *Post) delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 

} 


代码 清单 10-2 ”定义 了 Go Web 服 务 的 server .go 


package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 


) 


type Post struct { 
Id int json:"id". 
Content string `json:"content"` 
Author string ~json:"author"~ 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/post/", handleRequest) 


server.ListenAndServe() 


} 


func handleRequest(w http.ResponsewWriter, r *http.Request) { 


var err error 
switch r.Method { 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err = handleDelete(w, r) 


http.Error(w, err.Error(), http.StatusInternalServerError ) 


} 
if err != nil { 
return 
} 
} 


func handleGet(w http.Responsewriter, 
{ 


r *http.Request) (err error) 


id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 


w.Write(output ) 
return 
} 


func handlePost(w http.Responsewriter, 
{ 

len := r.ContentLength 

body := make([]byte, len) 

r.Body.Read( body ) 

var post Post 

json.Unmarshal(body, &post) 

err = post.create() 

if err != nil { 

return 


w.WriteHeader (200) 


r *http.Request) (err error) 


return 


} 


func handlePut(w http.Responsewriter, r *http.Request) (err error) 


{ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 


len := r.ContentLength 
body := make([]byte, len) 

r .Body.Read( body ) 
json.Unmarshal(body, &post) 
err = post.update() 


if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


} 


func handleDelete(w http.Responsewriter, r *http.Request) (err 
error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 

} 

post, err := retrieve(id) 

if err != nil { 
return 

} 

err = post.delete() 

if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


首先 ， 我 们 需要 使 用 以 下 命令 编译 这 段 代 码 : 


go build 


如 有 条 我 们 把 简单 Web 服 务 的 代码 放 到 一 个 名 为 ws-s 的 目 永 里 ， 那 
么 这 个 编译 命令 将 产生 一 个 同名 的 可 执行 二 进 制 文件 。 为 了 部 署 Web 服 
务 ws-s ， 我 们 需要 把 ws-s 文 件 复制 到 服务 器 里 ， 并 将 其 放置 到 一 个 可 
以 通过 外 部 访问 的 地 方 。 


接着 我 们 只 需要 登录 服务 器 ， 并 在 终端 里 执行 以 下 命令 ， 就 可 以 
行 ws -s 这 个 Web 服 务 了 : 


(Ni 


./WS-S 


需要 注意 的 是 ， 因 为 Web 服 务 现在 是 在 前 台 运行 ， 所 以 在 服务 运行 
期 间 ， 我 们 将 无 法 执行 其 他 操作 。 与 此 同时 ， 我 们 也 无 法 简单 地 通过 & 
命令 或 者 bg 命令 在 后 台 运 行 这 个 服务 ， 因 为 这 样 做 的 话 ， 一 旦 用 户 登 
出 ，Web 服 务 融会 被 杀 死 。 


避免 上 述 问题 的 一 种 方法 就 古 使 用 nohup 命令 ， 让 操作 系统 在 用 
户 注销 时 ， 把 发 送 至 Web 服 务 的 HUP (hangup, 4) 信号 忽略 掉 : 


nohup ./ws-s & 


执行 上 述 命令 将 导致 Web 服 务 被 放 到 后 合 运 行 ， 并 且 不 用 担心 因为 
HUP 信和 号 而 被 杀 死 。 以 这 种 方式 局 动 鸭 Web 服 务 仍 会 如 音 地 与 客户 病 进 
行 连接 ， 但 现在 的 web 服务 将 忽略 所 有 挂 起 或 者 退出 信号 。 因 为 这 种 状 
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服务 器 重 局 之 后 ， 用 户 必 须 重 新 登入 系统 并 重启 服务 。 


除 nohup 之 外 ， 持 续 运 行 Web 服 务 的 另 一 种 方法 是 使 用 Upstart 或 
者 systemd 这 样 的 init 守护 进程 : init 进程 是 类 Unix 系 统 在 局 动 时 运 
行 的 第 一 个 进程 ， 该 进程 由 内 核 负 责 局 动 ， 它 会 一 直 运 行 直 到 系统 > 
ARE, 并 且 它 还 是 其 他 所 有 进程 直接 或 间接 的 祖先 。 


Upstart 是 由 Ubuntu 创 建 的 一 个 基于 事件 的 jnit 替代 品 ， 尽 管 现在 
systemd 也 越 来 越 受 到 大 家 的 青睐 ， 但 考虑 到 这 两 个 工具 都 能 够 完成 本 
节 介 绍 的 工作 ， 并 且 Upstart 的 使 用 方法 相对 来 说 要 更 为 简单 一 些 ， 所 
以 我 们 接 下 来 将 要 学 习 如 何 使 用 Upstart 来 持续 地 运行 Web 服 务 。 


为 了 使 用 Upstart， 用 户 首先 需要 创建 一 个 对 应 的 Upstart 任 务 配 置 
文件 ， 并 将 该 文件 放 到 etc/init 目录 里 面 。 对 简单 Web 服 务 来 说 ， 我 
们 将 创建 代码 清单 10-3 所 示 的 ws ,conf 文件 ， 并 将 它 放 到 etc/init 
目录 里面。 


代码 清单 10-3 ”简单 Web 服 务 的 Upstart 任 务 配置 文件 


respawn 
respawn limit 10 5 


setuid sausheong 
setgid sausheong 


exec /go/src/github.com/sausheong/ws-S/ws-s 


XS Upstartt£ HS Bc BC PAR is fa] LA Be o AFF RYE PUpstart 
任务 都 由 一 个 或 任意 多 个 称 为 万 (stanzas) 的 命令 块 组 成 。 第 一 市 


respawn 指示 当 任 务 失效 (fail) 时 ，Upstart 将 对 其 实施 重新 派生 

(respawn) 或 者 重新 启动 。 第 二 节 respawn limit 10 5 为 
respawn 设置 了 参数 ， 它 指示 Upstart 最 多 只 会 党 试 重新 派生 该 任务 10 
次 ， 并 且 每 次 尝试 之 间 会 有 5 s 的 间隔 ， 在 用 完了 10 次 重新 派生 的 机 会 
之 后 ，Upstart 将 不 再 尝试 重新 派生 该 任务 ， 并 将 该 任务 视 为 已 失效 。 
第 三 节 和 第 四 节 负 责 设 置 运行 进程 的 用 户 以 及 用 户 组 ， 而 最 后 一 节 则 
是 Upstart 在 启动 任务 时 需要 运行 的 可 执行 文件 。 


为 了 启动 上 述 Upstart 任 务 ， 我 们 需要 在 终端 里 面 执行 以 下 命令 : 


sudo start ws 
ws start/running, process 2011 


这 个 命令 将 触发 Upstart 读 取 /etc/init/ws .conf 任务 配置 文件 
并 启动 任务 。 本 市 以 管 中 舌 鹏 的 方式 ， 快 速 地 了 解 了 如 何 使 用 简单 的 
Upstart 任 务 运行 一 个 Go Web 应 用 ， 但 是 除 这 里 介绍 的 内 容 之 外 ， 
Upstart 的 任务 配置 文件 还 有 其 他 不 同 的 节 可 供 使 用 ， 并 且 Upstart 的 任 
务 也 拥有 多 种 不 同 的 配置 方式 可 以 使 用 ， 不 过 这 些 内 容 不 在 本 书 的 介 
绍 范围 之 内 ， 有 兴趣 的 读者 可 以 目 行 通过 互联 网 进行 了 解 。 


为 了 驴 证 Upstart 是 否 能 够 正确 地 运行 和 管理 ws-s 服务 ， 我 们 可 以 
笑 试 在 Upstart 任 务 局 动 之 后 ， 共 死 正在 运行 的 ws-s 服务 : 


ps -ef | grep ws 
sausheo+ 2011 1 © 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws - 
S/WS-S 


sudo kill -0 2011 


ps -ef | grep ws 
sausheo+ 2030 1 © 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws - 
S/WS-S 


注意 看 ， 在 kill 命令 执行 之 前 ，ws-s 进程 的 ID 为 2011 ， 但 是 
fEkill 命令 执行 之 后 ，ws -ss 进程 的 有 D 变 成 了 2030 一 一 这 是 因为 
UpstartfEkill 命令 执行 之 后 ， 穴 觉 到 了 ws - s 进程 已 被 天 闭 ， 于 是 它 
重启 了 ws - s 进程 ， 从 而 导致 ws -s 进程 的 ID 发 生 了 变化 。 


最 后 ， 因 为 大 部 分 web 应 用 都 部 署 在 标准 HTTP 端 口 〈 即 80 端 口 ) 
之 上 ， 所 以 读者 在 实际 部 署 时 ， 应 该 将 简单 web 服务 代码 中 的 端口 号 从 
现在 的 8080 改 为 80， 或 者 通过 某 种 机 制 将 8080 端 口 的 流量 代理 或 者 重 
定向 到 80 端 口 。 


10.2 ”将 应 用 部 署 到 Heroku 


在 上 一 市 中 ， 我 们 学 习 了 如 何 将 一 个 简单 的 Go Web 上 服务 部 署 到 独 
立 的 服务 器 上 面 ， 以 及 如 何 通过 init 守护 进程 管理 Web 服 务 。 在 本 节 
中 ， 我 们 将 要 学 习 如 何 将 同样 的 Web 服 务 部 署 到 PaaS 供 应 商 Heroku 上 
面 ， 这 种 部 车 方 式 跟 上 一 下 介绍 的 部 署 方 式 一 样 简单 。 


Heroku 人 允许 用 户 部 署 、 运 行 和 管理 使 用 包括 Go 在 内 的 几 种 编程 语 
言 开 发 的 应 用 。 根 据 Heroku 的 定义 ， 一 个 应 用 Wize HHerokus¢ FRAY AE 
一 种 编程 语言 编写 的 一 系列 源 代 码 ， 以 及 与 这 些 源 代 码 相关 联 的 依赖 


Heroku 的 预 设 条 件 非常 商 单 ， 它 只 要 求 用 户 提 供 以 下 几 样 东西 : 


定义 依赖 关系 的 配置 文件 或 者 相关 机 制 ， 如 Ruby 的 Gemfile X 
件 、Node.js 的 package. json 文件 或 者 Java 的 pom.xml 文件 ; 
定义 可 执行 文件 的 Procfile 文件 ， 其 中 可 执行 文件 可 以 有 不 止 


= 


Heroku 大 量 地 使 用 命令 行 ， 并 因此 提供 了 一 个 名 为 toolbelt 的 命令 
行 工 具 ， 用 于 部 署 、 运 行 和 管理 应 用 。 此 外 ，Heroku 还 需要 通过 Git 将 
被 部 署 的 源码 推送 至 服务 器 。 当 Heroku 平 台 接 收 到 Git 推 送 的 代码 时 ， 
它 会 构建 代码 并 获取 指定 的 依赖 关系 ， 然 后 将 构建 的 结果 以 及 相应 的 
依赖 天 系 组 装 到 一 个 slug 里 面 ， 最 后 在 Heroku 的 dynos 上 运行 这 个 slug 
(dynos 是 Heroku 对 隔离 式 、 轻 量 级 、 虚 拟 化 的 Unix 容 器 的 称呼 ) 。 


尽管 菜 些 管理 和 配置 工作 可 以 在 之 后 通过 Web 界 面 来 完成 ， 但 
Heroku 最 主要 的 操作 界面 还 是 它 的 命令 行 工 具 toolbelt， 因 此 我 们 在 注 
有 册 完 Heroku 之 后 的 第 一 件 事 ， 就 是 访问 https:// toolbelt.heroku.com 下载 
toolbelt ° 


Heroku 是 一 个 非典 型 的 PaaS 供 应 商 ， 人 们 想 要 使 用 PaaS 来 部 署 Web 
应 用 的 原因 有 很 多 ， 对 Web 应 用 的 开发 者 来 说 ， 最 主要 的 原因 莫 过 于 
PaaS 可 以 让 基础 设施 和 系统 层 变 得 抽象 ， 并 且 不 再 需要 人 工 的 管理 和 
干预 。 尽管 PaaS 在 企业 级 IT 基 础 设施 这 样 的 大 规模 生产 环境 中 并 不 少 
见 ， 但 它们 对 小 型 公司 和 创业 公司 来 说 却 能 够 提供 极 大 的 方便 ， 并且 
能 够 有 效 地 减少 这 些 公 司 在 基础 设施 方面 的 前 期 投入 。 


在 下 载 完 toolbelt 之 后 ， 用 户 需要 使 用 注册 账号 时 获得 的 凭据 登入 
Heroku: 


heroku login 
Enter your Heroku credentials. 


Email: <your email> 
Password (typing will be hidden): 
Authentication successful. 


图 10-1 展 示 了 将 简单 Web 服 务 部 署 到 Heroku 的 具体 步骤 。 


为 了 将 简单 Web 应 用 部 署 到 Heroku， 我 们 需要 对 这 个 应 用 的 代码 做 
一 些 细微 的 修改 : 在 当前 的 代码 中 ， 应 用 使 用 的 是 8080 端 口 ， 但 是 在 
把 应 用 部 署 到 Heroku 的 时 候 ， 用 户 是 无 法 控制 应 用 使 用 哪个 端口 的 ， 
程序 必须 通过 读 取 环境 变量 PORT 来 获知 自己 能 够 使 用 的 端口 号 。 为 
此 ， 我 们 需要 将 server .go 文件 中 main 函数 的 代码 从 现在 的 : 


func main() { 
server := http.Server{ 
Addr: ":8080", 


} 
http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


修改 为 : 


func main() { 
server := http.Server{ 
Addr: ":" + os.Getenv("PORT"),// @ 


} 
http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


@ 从 环境 变量 中 获取 端口 号 
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ASER 引入 依赖 关系 创建 Heroku 应 用 至 Heroku 应 用 


图 10-1 将 Web 应 用 部 署 到 Heroku 的 具体 步 又 


以 上 就 是 将 简单 Web 应 用 部 署 天 Heroku 所 需要 做 的 全 部 代码 修改 ， 
其 他 代码 只 要 你 留 原 样 即 可 。 在 修改 完 代 码 之 后 ， 我 们 接 下 来 要 做 的 
就 是 将 简单 Web 应 用 所 需 的 依赖 关系 告知 Heroku。Heroku 使 用 godep 
(https://github.com/tools/godep) 来 管理 Go 的 依赖 关系 ，godep 可 以 通 
过 执行 以 下 命令 来 安装 : 


go get github.com/tools/godep 


在 godep 安 装 完 毕 之 后 ， 我 们 需要 使 用 它 来 引入 简单 Web 服 务 的 依 
赖 关系 。 为 此 ， 我 们 需要 在 简单 Web 服 务 的 根 目 录 中 执行 以 下 命令 : 


godep Save 


这 条 命令 不 仅 会 创建 一 个 名 为 Godeps 的 目录 ， 它 还 会 获取 代码 中 
的 全 部 依赖 关系 ， 并 将 这 些 依赖 关系 的 源 代码 复制 到 
Godeps/_workspace 目录 中 。 除 此 之 外 ， 这 个 命令 还 会 创建 一 个 名 
为 Godeps .json 的 文件 ， 并 在 该 文件 中 列 出 代码 中 的 全 部 依赖 关系 。 
作为 例子 ， 代 码 清单 10-4 展 示 了 godep 为 简单 Web 服 务 创建 的 
Godeps.json 文 件 。 


代码 清单 10-4 Godeps .json 文件 


"ImportPath": "github.com/sausheong/ws-h", 
"GoVersion": "go1.4.2", 
"Deps": [ 

{ 


"ImportPath": "github.com/lib/pq", 
"Comment": "go1.0-cutoff-31-ga33d605", 
"Rev": "a33d6053e025943d5dc89dfaif35fe5500618dF7" 


因为 我 们 的 简单 Web 服 务 只 需要 依赖 Postgres 数 据 库 驱 动 ， 所 以 文 
件 中 只 出 现 了 关于 该 驱动 的 依赖 信息 。 


在 Heroku 上 实施 部 署 需要 做 的 最 后 一 件 事 ， 就 是 定义 一 个 
Procfile 文件 ， 并 使 用 该 文件 去 描述 需要 被 执行 的 可 执行 文件 或 者 
主 函 数 。 代 码 清单 10-5 展 示 了 简单 Web 服 务 的 Procfile 文件 。 


代码 清单 10-5 Procfile 文件 


整个 文件 非常 简单 ， 只 有 短 短 的 一 行 。 这 个 文件 定义 了 Web 进 程 与 
ws-h 可 执行 二 进 制 文件 之 间 的 关联 ，Heroku 在 完成 应 用 的 构建 工作 之 
后 ， 就 会 执行 ws-h 文件 。 


准备 工作 一 切 束 绪 之 后 ， 我 们 接 下 来 要 做 的 就 是 将 简单 Web 服 务 的 
代码 推送 至 Heroku。Heroku 人 允许 用 户 通 过 GitHub 和 集成、Dropbox 同 步 、 
Heroku 官 方 提 供 的 API 以 及 标准 的 Git 操 作 等 多 种 不 同 的 手段 来 推送 代 
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服务 推送 至 Heroku 。 


在 推送 代码 之 前 ， 用 户 首先 需要 创建 一 个 Heroku 应 用 : 


heroku create ws-h 


这 条 命令 将 创建 一 个 名 为 ws -h 的 Heroku 应 用 ， 该 应 用 最 终 将 在 地 
址 https://ws-h.herokuapp.com 上 展示 。 需 要 注意 的 是 ， 因 为 本 书 在 这 里 
已 经 使 用 了 ws -h 作为 应 用 的 名 字 ， 所 以 读者 将 无 法 创建 相同 名 字 的 应 
用 。 为 此 ， 读 者 在 创建 应 用 的 时 候 可 以 使 用 其 他 名 字 ， 或 者 在 创建 应 
用 时 去 掉 名 字 参 数 ， 让 Heroku 为 应 用 目 动 生成 一 个 随机 的 名 字 : 


heroku create 


heroku create 命令 将 为 我 们 的 简单 Web 服 务 创建 一 个 本 地 的 
Git 代 码 库 (repository) ， 并 在 代码 库 中 添加 远程 Heroku 代 码 库 的 地 
址 。 因 此 ， 用 户 在 创建 完 Heroku 应 用 之 后 ， 就 可 以 通过 以 下 命令 使 用 
Git 将 应 用 代码 推送 至 Heroku: 


git push heroku master 


因为 Heroku 在 接收 到 用 户 推 送 的 代码 之 后 束 会 日 动 触发 相应 的 构 
建 以 及 部 署 操作 ， 所 以 将 应 用 部 署 到 Heroku 的 工作 到 此 就 可 以 告 一 段 
落 了 “。 除 上 面 提 到 的 工具 之 外 ，Heroku 还 提供 了 一 系列 非常 棒 的 应 用 


管理 工具 ， 这 些 工具 可 以 对 应 用 进行 性 能 扩展 以 及 版 本 管理 ， 并 且 和 在 
需要 时 ， 用 户 也 可 以 使 用 Heroku 提 供 的 配置 工具 添加 新 的 服务 ， 有 兴 
趣 的 读者 可 以 自行 查阅 Heroku 提 供 的 相关 文档 。 


10.3 ”将 应 用 部 署 到 Google App Engine 


Google App Engine (GAE) 是 另 一 个 流行 的 Go Web 应 用 PaaS 部 署 
平台 。Google 公 司 在 它 的 云 平台 产品 套件 中 包含 了 App Engine (应 用 引 
擎 ) 和 Compute Engine (计算 引 警 ) 等 多 种 服务 ， 其 中 App Engine 为 
PaaS 服 务 ， 而 Compute Engine 则 跟 AWSs 的 EC2 和 Digital Ocean 的 Droplets 
一 样 ， 是 一 个 IaaS 服 务 。 使 用 EC2 和 Droplets 这 样 的 服务 跟 使 用 上 自 有 的 
虚拟 机 或 者 服务 妖 并 没有 太 大 区 别 ， 并 且 我 们 已 经 在 上 一 三 学 习 过 如 
何在 类 似 的 平台 上 进行 部 署 ， 因 此 在 这 一 节 ， 我 们 要 学 习 如 何 使 用 
GAE 这 于 由 Google 公 司 提供 的 强大 的 PaaS 服 务 。 


人 们 选择 使 用 GAE 而 不 是 包括 Heroku 在 内 的 其 他 PaaS 服 务 的 原因 
通常 会 有 好 几 种 ， 但 其 中 最 主要 的 原因 还 是 跟 性 能 和 可 扩展 性 有 关 。 
GAE 能 够 让 用 户 构建 出 可 以 根据 负载 自动 进行 性 能 扩展 和 人 负载 平衡 的 
应 用 ， 并 有 旦 Google 公 司 除 为 GAE 提 供 了 大 量 的 工具 之 外 ， 还 在 GAE 内 
部 构建 了 大 量 的 功能 。 比 如 ，GAE 人 允许 用 户 的 应 用 通过 身份 验证 功能 
登录 Google 账 号 ， 并 且 GAE 还 提供 了 发 送 邮 件 、 创 建 日 志 、 发 布 和 管 
理 图 片 等 多 种 服务 。 除 此 之 外 ，GAE 用 户 还 可 以 非常 简单 直接 地 在 自 
己 的 应 用 中 集成 其 他 Google API ° 


虽然 GAE 拥 有 如 此 多 的 优点 ， 但 天 下 并 没有 免费 的 午餐 一 一 GAE 
在 拥有 众多 优点 的 同时 ， 也 拥有 不 少 限制 和 缺 氮 ， 其 中 包括 : HPR 


拥有 对 文件 系 乡 请 求 时 长 不 能 超过 60 s (否则 GAE 将 强制 杀 
死 该 请 求 ) ， 无 法 进行 直接 的 网 络 访问 ， 无 法 创建 其 他 类 型 的 系统 调 
用 ， E 能 (至 少 是 无 法 轻易 地 ) 访问 
Google 应 用 环境 沙 箱 (sandbox) 之 外 的 其 他 大 量 服务 。 


图 10-2 展 示 了 在 GAE 上 部 署 Web 应 用 的 大 致 步骤 


修改 代码 ， 使 用 将 应 用 代码 
Eee 创建 appyml 文 件 创建 GAE 应 用 MUD SALES 


图 10-2 ”在 GAE 上 部 署 应 用 的 大 致 步骤 


跟 其 他 所 有 Google 服 务 一 样 ， 使 用 GAE 也 需要 一 个 Google 账 号 。 
跟 Heroku 大 量 使 用 命令 行 界 面 的 做 法 不 同 ， 在 GAE 上， 对 Web 应 用 的 大 
部 分 管理 和 维护 操作 都 是 通过 名 为 Google Developer Console (开发 者 
控制 台 ) 的 Web 界 面 完 成 的 。 虽 然 GAE 也 拥有 与 开发 者 控制 台 具 有 同等 
功能 的 命令 行 接 口 ， 但 Google 公 司 的 命令 行 工具 并 没有 像 Heroku 那 样 
集成 这 些 接 口 。 图 10-3 展 示 了 Google 开 发 者 控制 台 的 使 用 界面 。 


除了 注册 账号 之 外 ， 使 用 GAE 需 要 做 的 另 一 件 事 就 是 访问 
https://cloud.google.com/appengine/ downloads 下 载 相 应 的 SDK (Software 
Development Kit， 软 件 开发 工具 包 ) 。 在 这 个 例子 中 ， 我 们 将 下 载 
GAF 为 Go 语言 提供 的 SDK ° 


eee < I console.developers.google.com/project 


jrade your account. Only $299.49 and 54 days A 
Google | roject ~ | 
“O Sect a projec rain in your free trial O (2) Le 49 
Project Name Project ID Requests Errors Charges 
ws-g 7 5 


Projects pending deletior 


图 10-3 ”使 用 Google 开 发 者 控制 台 创建 GAE Web 应 用 


A 其 人 002 报信 | 


GAE 和 Google Cloud SQL 这 样 的 Google 服 务 并 不 是 免费 的 。Google 公 司 会 为 新 注册 的 用 | 
户 提供 60 天 的 试用 期 以 及 价值 300 美 元 的 试用 额度 ， 因 此 读者 应 该 a 绍 的 | 
内 容 ， 但 是 当 试 用 期 到 期 或 者 试用 额度 耗 尽 时 ， 读 者 就 需要 付费 才能 继续 使 用 这 些 服务 了 。 

在 安装 完 SDK 之 后 ， 我 们 接 下 来 要 做 的 是 对 GAE 的 数据 存储 
(datastore) 进行 配置 。 正 如 前 所 说 ，Google 公 司 对 直接 的 网 络 访问 有 

严格 的 限制 ， 用 户 是 无 法 直接 连接 外 部 的 PostgreSQL 服 务 器 的 。 为 
此 ， 在 这 一 节 中 ， 我 们 将 使 用 Google 公 司 提供 的 Google Cloud SQL 服 务 
来 代替 PostgreSQL 。 Cloud SQL 是 一 个 基于 MySQL 的 云端 数据 
库 服 务 ， 用 户 可 以 通过 cloudsql 包 直 接 在 GAE 中 使 用 该 服务 。 


为 了 使 用 Google Cloud SQL， 我 们 需要 先 通过 开发 者 控制 台 创建 一 
个 数据 库 实例 ， 具 体 步 又 如 图 10-4 所 示 。 用 户 首先 需要 在 控制 台 上 点 击 
自己 创建 的 项 目 (在 这 个 例子 中 ， 我 创建 的 项 目 名 为 ws-g-1234 ) ， 
接着 在 左 侧 的 导航 面板 中 点 击 “Storage”( 存 储 ) ， 然 后 再 选择 其 中 
的 “Cloud SQL”， 从 而 进入 Cloud SQL 的 设置 页 面 。 在 点 击 “New 
Instance” (SEA) 按钮 之 后 ， 用 户 将 会 看 到 一 些 与 创建 数据 库 实例 有 
天 的 选项 。 这 些 选 项 中 的 大 部 分 已 经 预先 设置 好 了 ， 需 要 改动 的 地 方 
不 多 ， 我 们 唯一 要 做 的 就 是 将 “Preferred location”( 首 选 位 置 ) 选项 设 
置 为 “Follow App Engine App”( 与 App Engine 的 应 用 保持 一 致 ) ， 并 让 
项 目的 应 用 ID 保 持 默 认 值 不 变 。 在 进行 了 上 述 设置 之 后 ， 我 们 的 GAE 
应 用 束 能 够 正常 访问 数据 库 实例 了 。 


需要 注意 的 是 ， 因 为 Google 公 司 默认 会 为 用 户 的 数据 库 实例 提 供 
一 个 免费 的 IPv6 地 址 ， 但 是 却 不 会 提供 IPv4 地 址 ， 所 以 如 末 你 的 时 面 计 
算 机 、 移 动 电脑 、 服 务 器 或 者 你 正在 使 用 的 网 络 供 应 两 并 没有 使 用 
IPV6 连 接 ， 那 么 你 还 需要 花 一 点 额外 的 钱 去 获取 一 个 IPv4 地 址 ， 并 将 这 
个 地 址 添加 到 设置 页 面 。 


3. 选择 Follow App Engine App. 


@ee < (am console.developers.google.com/project/ws-g-1234/sql/create ® 口 
Gu ws-g 二 Only $299.49 and 54 days remain in your free trial O [2] a A 
Compute 
Preferred location App Engine application ID 
App Engine 
Follow App Engine App d ws-g-1234 
Backups 
v Enable backups 12:00 PM — 4:00 PM 
Binary log (requires backups) 
Activation policy 
@ On Demand 
Always On 
Compute Engine Never 
Container Engine 
Networking File system replication 


@ Synchronous 
Storage y 


Cloud Bigtable Asynchronou 
Cloud Datastore 


id SQL IPv4 address 


Cloud Storage Assign an IPv4 address to my Cloud SQL instance. 
Big Data 3 
1. 点 击 Storage， 2. 选择 Cloud SQL. 4. 设置 IPv4 IP 地 址 。 


展示 存储 菜单 。 


图 10-4 通过 开发 者 控制 台 创建 一 个 Google Cloud SQL 数据 库 实例 


除 以 上 提 到 的 少数 几 个 选项 之 外 ， 其 他 选项 只 需要 保留 默认 即 
可 。 在 最 后 ， 用 户 只 需要 为 自己 的 实例 设置 一 个 名 字 ， 一 切 就 大 功 告 
成 了 。 


也 许 你 已 经 预料 到 了 ， 因 为 GAE 平 台 是 如 此 地 别具一格 ， 所 以 为 
了 将 Web 应 用 部 署 到 这 个 平台 上 ， 对 代码 的 修改 自然 也 变 得 无 法 避免 
了 。 下 面 从 高 层次 的 角度 列 出 了 将 简单 Web 服务 部 署 到 GAE 所 需要 做 
的 一 些 事情 : 


。 修改 包 名 ， 不 再 使 用 main 作为 包 名 ; 

。 移 除 main HA, 

。 把 处 理 器 的 注册 语句 移 到 init 函数 里 面 ; 

。 使 用 MySQL 数 据 库 驱 动 代 蔡 PostgreSQL 数 据 库 驱 动 ; 
。 把 SQL 查询 修改 为 MySQL 格 式 。 


因为 GAE 将 接管 被 部 署 的 整个 应 用 ， 所 以 用 户 将 无 法 控制 应 用 何 
时 被 局 动 或 者 运行 在 哪个 端口 之 上 。 实 际 上 ， 用 户 编写 的 将 不 再 是 一 
个 独立 的 应 用 ， 而 是 一 个 部 署 在 GAE 上 的 包 。 这 样 导致 的 结果 是 ， 用 
户 将 不 能 再 使 用 main 这 个 为 独立 的 Go 程序 预 留 的 包 名 ， 而 是 要 将 包 名 
修改 为 main 以 外 的 其 他 名 字 。 


接 下 来 ， 用 户 还 需要 移 除 程序 中 的 main 函数 ， 并 将 该 函数 中 的 代 
码 移 到 init 函数 。 对 简单 Web 服 务 来 说 ， 我 们 需要 将 原来 的 main K 
aN: 


func main() { 
server := http.Server{ 
Addr: ":8080", 


} 
http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


修改 为 以 下 init KZ: 


func init() { 
http.HandleFunc("/post/", handlePost) 


注意 ， 在 新 的 jnit 函数 里 ， 原 本 用 于 指定 服务 器 地 址 以 及 端口 号 
的 代码 已 经 消失 ， 同 样 消失 的 还 有 用 于 局 动 Web 上 服务器 的 相关 代码 。 


考 虚 到 我 们 还 需要 将 简单 Web 服 务 使 用 的 数据 库 驱 动 从 PostgreSQL 
切换 至 MySQL， 因 此 我 们 需要 在 data.go 中 导入 MySQL 数 据 库 张 
动 ， 并 设置 正确 的 数据 连接 字符 串 : 


import ( 
"database/sql" 
_ "github.com/ziutek/mymysql/godrv" 


) 
func init() { 
var err error 
Db, err = sql.Open("mymysql", "cloudsql:<app ID>:<instance name>* 


<database 
™=name>/<user name>/<password>" ) 
if err != nil { 
panic(err) 


除了 上 述 修改 之 外 ， 我 们 还 需要 将 相应 的 SQL 查询 修改 为 MySQL 
格式 。 尽 管 这 两 种 数据 库 使 用 的 语法 非常 相似 ， 但 并 不 完全 相同 ， 所 
以 程序 是 无 法 在 不 做 修改 的 情况 下 直接 运行 的 。 比 如 ， 对 于 以 下 代码 
中 加 粗 显示 的 SQL 查 询 语句 : 


func retrieve(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id 


=$1 


", id).Scan(&post.Id, &post.Content, &post.Author) 
return 


Po 
我 们 将 不 再 使 用 诸如 $1 + $2 这 样 的 标识 ， 而 是 使 用 ? 来 表示 被 巷 
换 的 变量 ， 残 像 这 样 : 


func retrieve(id int) (post Post, err error) { 
post = Post{} 


err = Db.QueryRow( "select id, content, author from posts where id 
son 
= | 


=id).Scan(&post.Id, &post.Content, &post.Author) @ 
return 


@ 根据 MySQL 的 查询 格式 ， 将 原来 的 $n 标识 修改 为 ?标识 


在 对 代码 做 完 必要 的 修改 之 后 ， 我 们 接 下 来 还 要 创建 一 个 对 应 用 
进行 描述 的 app .yaml 文件 ， 如 代码 清单 10-6 所 示 。 


代码 清单 10-6 ”用 于 GAE 部 署 的 app.yaml 文 件 


application: ws-g-1234 
version: 1 

runtime: go 

api version: got 


handlers: 
- url: /.* 


script: _go_app 


这 个 文件 非 党 简单， 一目了然， 读者 在 进行 测试 时 ， 唯 一 需要 做 
的 束 古 在 这 个 文件 中 修改 应 用 的 名 子 ， 然 后 一 切 束 大 功 告 成 了 ! 以 上 


就 是 将 简单 Web 服 务 部 团 到 GAE 上 所 需要 做 的 全 部 工作 ， 接 下 来 ， 是 时 
候 对 这 个 将 要 运行 在 GAE 之 上 的 简单 Web 服 务 做 一 些 测试 了 |! 


因为 我 们 在 前 面 对 应 用 做 了 大 量 的 修改 ， 所 以 可 能 会 有 读者 觉得 
自己 已 经 无 法 在 本 地 的 机 器 上 运行 这 个 应 用 了 ， 不 过 这 种 担心 是 不 必 
要 的 一 一 开发 者 只 需要 使 用 Google 公 司 提供 的 GAE SDK， 就 可 以 在 本 
地 运行 自己 的 GAE 应 用 了 。 


在 按照 下 载 页 面 提供 的 指示 安装 了 GAE SDK 之 后 ， 我 们 只 需要 在 
应 用 的 根 目 隶 下 使 用 终端 执行 以 下 命令 ， 右 可 以 运行 自己 的 GAE Web 
YHT: 


goapp serve 


GAE SDK 提 供 了 在 本 地 运行 GAE 应 用 所 需 的 环境 ， 从 而 使 用 户 可 
以 在 本 地 测试 目 己 的 应 用 。 除 此 之 外 ，GAE SDK 还 提供 了 一 个 本 地 运 
行 的 管理 网 站 (admin site) ， 用 户 只 需 访问 http://localhost:8000/， 就 可 
以 通过 该 网 站 检视 目 己 编写 的 代码 。 壮 憾 的 是 ， 在 撰写 本 书 的 时 候 ， 
开发 环境 还 不 文 持 Cloud SQL， 所 以 我 们 还 无 法 直接 在 本 地 测试 简单 
Web 服 务 。 解 决 这 个 问题 的 一 种 方法 是 在 本 地 使 用 MySQL 服 务 器 进行 
测试 ， 然 后 在 生产 环境 中 继续 使 用 Cloud SQL 数据 库 。 


在 确保 应 用 一 切 正常 之 后 ， 用 户 就 可 以 通过 执行 以 下 命令 ， 将 应 
用 部 署 到 Google 公 司 的 服务 右上 了 : 


goapp deploy 


在 执行 以 上 命令 之 后 ，SDK 将 把 应 用 的 代码 推送 到 Google 公 司 的 
服务 器 ， 然 后 由 服务 器 对 其 进行 编译 和 部 署 。 如 果 一 切 正 常 ， 被 推送 
的 应 用 将 如 期 地 出 现在 互联 网 上 。 比 如 ， 我 们 可 以 通过 http://ws-g- 
1234.appspot.com/ 访 问 名 为 Ws-g-1234 的 应 用 。 


为 了 测试 这 个 刚刚 部 署 完毕 的 简单 Web 服 务 ， 我 们 可 以 使 用 以 下 命 
令 ， 让 curl 向 服务 器 发 送 一 个 创建 数据 库 记 录 的 POST 请 求 : 


curl -i -X POST -H "Content-Type: application/json" -d 
"£"content":"My first 

post", "author":"Sau Sheong"}' http://ws-g- 
1234.appspot.com/post/ 
HTTP/1.1 200 OK 


Content-Type: text/html; charset=utf-8 
Date: Sat, 01 Aug 2015 06:46:59 GMT 
Server: Google Frontend 
Content-Length: 0 

Alternate-Protocol: 80:quic, p=0 


现在 再 次 使 用 cunl 去 获取 刚刚 创建 的 数据 库 记 录 : 


curl -i -X GET http://ws-g-1234.appspot.com/post/1 
HTTP/1.1 200 OK 

Content-Type: application/json 

Date: Sat, 01 Aug 2015 06:44:29 GMT 

Server: Google Frontend 

Content-Length: 69 


Alternate-Protocol: 80:quic, p=0 


mig" . 1 

y f 
"content": "My first post", 
"author": "Sau Sheong" 


GAE 非 第 强大 ， 它 拥有 许 许多 多 的 功能 ， 这 些 功 能 可 以 帮助 开发 
者 在 互联 网 上 创建 和 部 署 可 扩展 的 Web 应 用 ,但 因为 GAE 是 Google 公 司 
开发 的 平台 ， 所 以 如 果 用 户 想 要 使 用 这 个 平台 ， 束 必须 遵守 这 个 平台 
的 规则 。 


10.4 ”将 应 用 部 署 到 Docker 


前 一 节 简 单 地 介绍 过 Docker， 讨 论 了 如 何 将 Go Web 应 用 封装 为 
Docker 容 器 并 将 其 推送 至 可 用 的 Docker 托 管 服 务 上 ， 而 在 本 节 中 ， 我 们 
将 会 更 加 完整 地 学 习 Docker 的 部 署 方 法 ， 并 人 研究 如 何 将 简单 Go Web 服 
务 部 署 到 本 地 Docker 条 主机 以 及 云端 鸭 Docker 箱 主机 之 上 。 


10.4.1 什么 是 Docker 


Docker 是 一 个 非常 了 不 起 的 项 目 ，PaaS 公 司 dotCloud 最 初 在 2013 年 
发 布 了 这 个 开源 项 目 ， 之 后 无 论 是 大 型 公司 还 是 小 型 公司 ， 都 被 这 一 
项 目 震 撼 了 “。Google、AWS 以 及 微软 这 样 的 技术 公司 都 在 拥抱 
Docker，AWS 拥 有 EC2 Container Service (容器 服务 ) ，Google 提 供 了 
Google Container Engine 〈 容 器 引擎 ) ，Digital Ocean、Rackspace 甚 至 
IBM 等 众多 云 供应 商 也 纷纷 加 入 了 文 持 Docker 的 行列 当中 。 除 此 之 外 ， 
像 BBC、ING 这 样 的 银行 以 及 高 盛 这 样 的 传统 公司 也 开始 在 内 部 尝试 使 
用 Docker。 


一 言 以 英之 ，Docker 就 是 在 容器 中 构建 、 发 布 和 运行 应 用 的 一 个 
开放 平台 。 容 器 并 不 是 一 项 新 技术 一 一 它 在 Unix 初 期 就 已 经 出 现 ， 
Docker 最 初 基 于 Linux 的 容 硕 就 是 在 2008 年 引入 的 。Heroku 的 dynos 同 样 
也 是 一 种 容器 。 


如 图 10-5 所 示 ， 容 事 与 虚拟 机 的 不 同 之 处 在 于 ， 虚 拟 机 模拟 的 是 包 
括 操 作 系 统 在 内 的 整个 计算 机 系统 ， 而 容 右 只 提供 操作 系统 级 别 的 虚 
拟 化 ， 并 将 计算 机 资源 划分 给 多 个 独立 的 用 户 空 间 实例 使 用 。 这 两 种 
虚拟 方式 的 差异 导致 容 右 对 资源 的 需求 比 虚 拟 机 要 少 得 多 ， 并 且 容 器 
的 启动 速度 和 部 署 速度 也 比 虚 拟 机 快 得 多 。 


虚拟 机 : 模拟 包括 操作 系统 容器 : 提供 操作 系统 级 别 的 虚拟 化 ， 
在 内 的 整个 计算 机 系统 并 将 资源 划分 给 多 个 用 户 空间 实例 


H 


图 10-5 ”容器 与 虚拟 机 的 不 同 之 处 在 于 ， 容 器 提供 的 是 操作 系统 级 别 的 虚拟 化 ， 并 且 容 器 可 以 
将 资源 划分 给 多 个 独立 的 用 户 空间 实例 


æn 


Docker 实 质 上 就 是 一 种 管理 容器 的 软件 ， 它 的 存在 使 开发 者 可 以 
更 为 简单 地 使 用 容器 。 除 Docker 之 外 ， 市 面 上 还 存在 着 chroot ` Linux 
containers (LXC) ` Solaris Zones、CoreOS 和 ]mctfy 等 一 系列 同类 软 
件 ， 但 Docker 是 其 中 名 声 最 显赫 的 一 款 。 


10.4.2 Docker 


Docker 目 前 只 能 在 基于 Linux 的 系统 上 工作 ， 但 它 也 提供 了 一 些 变 
通 的 方法 ， 使 OS X 用 户 和 Windows 用 户 也 能 够 在 自己 的 系统 上 使 用 
Docker 的 开发 工具 。 为 了 安装 Docker， 用 户 需 要 访问 
https://docs.docker.com/engine/installation， 然 后 根据 目 己 的 系统 以 及 想 
要 使 用 的 Docker 版 本 ， 按 照 说 明 安 装 。 对 于 Ubuntu Server 14.04， 我 们 
可 以 通过 执行 以 下 这 个 简单 的 命令 来 安装 Docker: 


wget -qO- https://get.docker.com/ | sh 


在 安装 Docker 之 后 ， 我 们 可 以 通过 执行 以 下 这 条 命令 来 确认 Docker 
是 否 已 经 安装 成 功 : 


sudo docker run hello-world 


这 条 命令 会 从 远程 代码 库 中 拉 取 hello-world 镜像 ， 并 作为 本 地 
SME 


= 
ea 
> 4 
=> 
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10.4.3 ”Docker 的 概念 与 组 件 


如 图 10-6 所 示 ，Docker 引 擎 ”( 人 简称 Docker) 包含 多 个 组 件 。 刚 才 
在 测试 Docker 安 装 是 否 成 功 时 ， 我 们 就 用 到 了 第 一 个 组 件 Docker 客 户 端 
它 就 是 用 户 在 与 Docker 守 护 进程 交互 时 所 使 用 的 命令 行 接口 。 


Docker 宿 主 


Docker 容 器 


D 


Docker 镜 像 Dockerfile 


图 10-6 Docker3|#£H Docker F vit ` Docker 守护 进程 以 及 不 同 的 Docker 容 器 组 成 ， 这 些 容器 
为 Docker 镜 像 的 实例 。Docker 镜 像 可 以 通过 Dockerfile 创 建 ， 并 且 镜 像 还 能 够 存储 在 Docker 注 册 
LÒ (registy) 


Docker 守 护 进 程 运行 在 宿主 操作 系统 (hostOS) 之 上 ， 该 进程 会 
对 客户 端 发 送 的 服务 请 求 进行 应 答 ， 并 对 容 郁 进行 管理 。 


Docker 容 器 〈 简 称 容 器 ) 是 对 运行 特定 应 用 所 需 的 全 部 程序 ( 包 
括 操作 系统 在 内 ) 的 一 种 轻 量 级 虚拟 化 。 轻 量 级 容器 会 让 应 用 以 及 与 
之 相关 联 的 其 他 程序 认为 目 己 独占 了 整个 操作 系统 以 及 所 有 硬件 ， 但 
征 实 际 上 并 非 如 此 ， 多 个 应 用 共享 同一 御 主 操作 系统 。 


Docker 容 器 都 基于 Docker 镜 像 构建 ， 后 者 是 辅助 容器 进行 启动 的 
只 读 模 板 ， 所 有 容器 都 需要 通过 镜像 启动 。 有 好 几 种 不 同 的 方法 可 以 
创建 Docker 镜 像 ， 其 中 一 种 就 是 在 一 个 名 为 Dockerfile 的 文件 里 包含 一 
系列 指令 


Docker 镜 像 既 可 以 以 本 地 形式 存储 在 运行 大 Docker 守 护 进 程 的 机 器 
上 (也 就 是 Docker 的 宿主 机 之 上 ) ， 也 可 以 被 托管 至 名 为 Docker 注 册 中 
心 的 Docker 镜 像 资 源 库 里 面 。 用 户 既 可 以 使 用 目 己 鸭 私有 Docker 注 册 中 
心 ， 也 可 以 使 用 Docker Hub (https://hub.docker.com/) 作为 自己 的 
registy。Docker Hub 同 时 提供 公开 和 私有 的 Docker 镜 像 ， 但 私有 的 
Docker 镜 像 需 要 付费 才能 使 用 。 


如 果 用 户 是 在 类 似 Ubuntu 这 样 的 Linux 系 统 上 安装 Docker， 那 么 
Docker 守 护 进 程 和 Docker 客 户 端 将 被 安装 到 同一 机 器 里 面 。 但 如 果 用 户 
是 在 OS X 和 Windows 这 样 的 系统 上 安装 Docker， 那 么 Docker 只 会 把 客 


户 端 安 装 在 操作 系统 里 面 ， 而 守护 进程 则 会 被 安装 到 其 他 地 方 ， 通 常 
会 是 一 个 运行 在 该 系统 之 上 的 虚拟 机 里 面 。 这 种 情况 的 一 个 例子 是 ， 
在 OS X 上 安装 Docker 时 ，Docker 客 户 端 将 被 安装 到 OS X 里 面 ， 而 
Docker 守 护 进 程 则 会 被 安装 到 VirtualBox (一 款 基于 x86 架 构 的 虚拟 机 监 
视 器 ) 的 一 个 虚拟 机 里 面 。 


在 此 之 后 ， 用 户 只 需要 通过 Docker 镜 像 来 运行 Docker 容 器 ， 并 将 其 
运行 在 Docker 簿 主 之 上 束 可 以 了 人。 


在 对 Docker 有 了 一 个 大 体 的 了 解 之 后 ， 我 们 是 时 候 来 学 习 如 何 将 
Web 应 用 部 畴 到 Docker 里 面 了 。 接 下 来 的 一 市 将 继续 使 用 前 面 展示 过 的 
简单 Web 服 务 作为 例 了 于， 演示 如 何 将 Web 应 用 部 署 到 Docker 容 磊 。 


10.4.4 ”Docker 化 一 个 Go Web 应 用 


尽管 Docker 使 用 了 那么 多 的 技术 ， 但 Docker 化 一 个 Go Web 应 用 却 
一 点 也 不 困难 。 因 为 Web 服 务 拥 有 对 整个 容器 的 完整 访问 权限 ， 所 以 我 
们 不 需要 对 服务 的 代码 做 任何 修改 ， 只 要 使 用 Docker 并 进行 相应 的 配 
置 就 可 以 了 。 作 为 例子 ， 图 10-7 从 高 层次 的 角度 展示 了 将 一 个 Web 应 用 
Docker 化 并 部 奢 到 本 地 以 及 云端 的 具体 步骤。 


ERTE, BOAR ws -d 作为 Web 服 务 的 名 字 。 部署 的 第 一 步 
征 在 应 用 程序 的 根 目 永 中 创建 一 个 代码 清单 10-7 所 示 的 Dockerfile 文 
人 


创建 使 用 Dockerfile 根据 Docker 在 云端 创建 连接 远程 在 远程 宿主 中 在 远程 宿主 中 
Dockerfile 构 gs ker ck ee Docker 宿 主 Docker 宿 主 构建 Docker 镜 像 / /启动 Docker 容 器 
H 
l 
l | | | 


部 署 到 本 地 服务 器 部 署 到 云端 


图 10-7 将 Go Web 应 用 Docker 化 并 部 署 到 本 地 以 及 云端 的 具体 步 又 


代码 清单 10-7 简单 Web 服 务 的 Dockerfile 文 件 


FROM golang ©@ 


ADD . /go/src/github.com/sausheong/ws-d @ 
WORKDIR /go/src/github.com/sausheong/ws -d 
RUN go get github.com/lib/pq © 


RUN go install github.com/sausheong/ws-d 


ENTRYPOINT /go/bin/ws-d © 


EXPOSE 8080 © 


@ 使 用 一 个 安装 了 Go 并 且 将 GOPATH 设置 为 /go 的 Debian 镜像 作 
为 容 絮 的 起 点 


O 把 本 地 的 包 文件 复制 到 容器 的 工作 空间 里 面 
© 在 容器 内 部 构建 ws-d 命令 

O 把 ws-d 命令 设置 为 随 容器 启动 

O 注 明 该 服务 监听 的 端口 号 为 8080 


这 个 Dockerfile 文 件 的 第 一 行 告诉 Docker 使 用 golang 镜像 启动 ， 
这 是 一 个 安装 了 最 新 版 Go 并 将 工作 空间 设置 为 /go 的 Debian 镜 像 。 之 


后 的 两 行 会 将 当前 目录 中 的 本 地 代码 复制 到 容器 中 ， 并 设置 相应 的 工 
作 目 好。 在 此 之 后 ， 文 件 使 用 RUN fit 48 7NDocker3k FX PostgreSQLAK 5 
并 构建 Web 服 务 的 代码 ， 然 后 将 可 执行 的 二 进 制 文件 放置 到 /go/bin 
目录 中 。 在 此 之 后 ， 文 件 使 用 ENTRYPOINT 命令 指示 Docker 

将 /go/bin/ws-d 设置 为 随 容器 启动 。 最后， 文件 使 用 EXPOSE 命令 
指示 容器 将 8080 端 口 驼 露 给 其 他 容器 。 需 要 注意 的 是 ， 这 个 EXPOSE fj 
令 只 会 对 同一 宿主 内 的 其 他 容器 打开 8080 端 口 ， 但 它 并 不 会 对 外 开放 
8080 端 口 。 


在 编写 好 Dockerfile 文 件 之 后 ， 我 们 避 ® 可 以 使 用 以 下 命令 来 构建 镜 
AT: 


docker build -t ws-d . 


这 条 命令 将 执行 Dockerfile 文 件 ， 并 根据 文件 中 的 指示 构建 一 个 本 
地 镜像 。 如 果 一 切 顺 利 ， 那 么 在 这 条 命令 执行 完毕 之 后 ， 用 户 应 该 可 
以 通过 docker images 命令 看 到 新 鲜 出 炉 的 镜像 文件 : 


REPOSITORY TAG IMAGE ID CREATED VIRTUAL 
SIZE 


ws-d latest 65e8437fce6b 10 minutes ago 534.7 MB 


在 成 功 创建 镜像 之 后 ， 我 们 避 ® 可 以 通过 运行 镜像 来 创建 和 局 动容 
Bo 了 i 


docker run --publish 80:8080 --name simple web service --rm ws-d 


这 条 命令 会 通过 ws - d 镜像 创建 出 一 个 名 为 
simple web service 的 容器 。- -publish80:8080 标 志 打开 
HTTP 端 口 80 并 将 其 映射 至 前 面 通过 EXPOSE 命令 暴露 的 8080 端 口 ， 而 
一 rm 标志 则 指示 Docker 在 容器 已 经 存在 的 情况 下 ， 先 移 除 已 有 的 容 
眉 ， 然 后 再 创建 并 启动 新 容器 。 如 果 不 设 置 - -rm 标志， 那么 Docker 在 
容器 已 经 存在 的 情况 下 将 保留 已 有 的 容器 ， 并 直接 启动 该 容器 ， 而 不 
是 创建 并 启动 新 容器 。 为 了 确认 容器 是 否 已 经 启动 ， 我 们 可 以 执行 以 
下 


AA 
4 


AH 


eer 


如 有 果 一 切 正 常 ， 你 的 容 吉 应 该 会 作为 其 中 一 员 ， 出 现在 已 激活 容 
an SP: 


CONTAINER ID IMAGE ... PORTS NAMES 


eeb674e289a4 ws-d ... 0.0.0.0:80->8080/tcp simple web service 


因为 页 面 宽度 的 限制 ， 这 里 忽略 了 docker ps 命令 输出 的 某 些 
列 ， 但 这 里 展示 的 信息 已 经 足以 表明 我 们 的 容器 现在 已 经 正常 地 运行 
在 本 地 的 Docker 宿 主 之 上 了 “。 跟 之 前 一 样 ， 我 们 可 以 通过 cur1l 命令 向 
服务 器 发 送 一 个 POST 请 求 ， 创 建 一 条 记录 : 


curl -i -X POST -H "Content-Type: application/json" -d 
'£{"content":"My first 

=post","author":"Sau Sheong"}' http://127.0.0.1/post/ 
HTTP/1.1 200 OK 

Content-Type: text/html; charset=utf-8 

Date: Sat, 01 Aug 2015 06:46:59 GMT 


Server: Google Frontend 
Content-Length: 0 
Alternate-Protocol: 80:quic, p=0 


现在 ， 通 过 curl 命 令 获取 之 前 创建 的 记录 : 


curl -i -X GET http://127.0.0.1/post/1 
HTTP/1.1 200 OK 

Content-Type: application/json 

Date: Sat, 01 Aug 2015 06:44:29 GMT 
Server: Google Frontend 
Content-Length: 69 


Alternate-Protocol: 80:quic, p=0 


"iq" . 1 

x 了 
"content": "My first post", 
"author": "Sau Sheong" 


10.4.5 ”将 Docker 容 器 推送 至 互联 网 


把 简单 Web 服 务 Docker 化 为 容 右 听 起 来 是 一 件 非 党 棱 的 事情 ， 但 这 
个 容 需 现在 还 只 是 运行 在 本 地 宿主 上 ， 而 我 们 真正 想 要 做 的 是 把 容器 
放 到 互联 网 上 运行 。 有 几 种 不 同 的 方法 可 以 把 Docker 容 万 部 署 到 远程 
往 主 上 运行 ， 目 前 来 疯 ， 最 商 单 的 一 种 方法 束 是 使 用 Docker 机 各 了 。 


Docker (machine) 是 一 个 命令 行 接 口 ， 它 允许 用 户 在 本 地 以 
及 云端 创建 公开 或 者 私有 的 Docker 牡 主 。 在 编写 本 书 时 ，Docker 机 器 文 
持 包 括 AWS、Digital Ocean ` Google Compute Engine ` IBM Softlayer ` 
Microsoft Azure ` Rackspace ` Exoscalef VMWare vCloud Air 在 内 的 公 
ASEMA; 与 此 同时 ，Docker 机 器 也 文 持 在 私有 云 供应 商 以 及 运行 
着 OpenStack、VMWare 或 者 Microsoft Hyper-V ZIEM A EOE E ° 


Docker les HÆR Docker — AREAS, He ACS © AA 
户 可 以 通过 克隆 代码 库 https:Wgithub.com/dockervmachine 或 者 从 
https://docs.docker.com/machine/install-machine/ 下 载 相应 平台 的 二 进 制 包 
来 安装 Docker 机 器 。 比 如 ， 使 用 Linux 的 用 户 就 可 以 通过 以 下 命令 来 获 
f$ Docker Lar AI EHE: 


curl -L 
https://github.com/docker/machine/releases/download/v0.3.0/docker - 


“machine _linux-amd64 /usr/local/bin/docker -machine 


在 下 载 完 二 进 制 包 之 后 ， 用 户 还 需要 执行 以 下 命令 将 二 进 制 包 变 
成 可 执行 文件 : 


chmod +x /usr/local/bin/docker-machine 
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轻松 的 一 种 办 法 就 是 使 用 Digital Ocean ° Digital Ocean 是 一 个 虚拟 专用 
服务 器 (virtual private server, VPS) 供应 商 ， 它 的 服务 以 易于 使 用 以 
及 价格 实惠 而 著称 (VPS 是 供应 商 以 服务 形式 销售 的 虚拟 机 ) ° Digital 
Ocean 在 2015 年 5 月 成 为 了 仪 次 于 AWS 的 世界 第 二 大 Web 服 务 器 托管 公 
司 。 


为 了 在 Digital Ocean 上 创建 Docker 和 宿主 ， 我 们 需要 先 申 请 一 个 
Digital Ocean 账号 ， 并 在 拥有 账号 之 后 ， 访 问 Digital Ocean 
的 “Applications & API” (应 用 与 API) 页 面 https://cloud.digitalocean.com/ 


settings/applications ° 


图 10-8 展 示 了 “Applications & API” 页 面 的 样子 ， 该 页 面 中 包含 了 一 
个 “Generate new token” (ERIKS) 按钮 ， 我 们 可 以 通过 点 击 这 个 
按钮 来 生成 一 个 新 的 令 脾 。 生 成 令 牌 时 首先 要 做 的 就 是 输入 一 个 名 
字 ， 并 人 勾 选 其 中 的 “Write”( 写 入 ) AWIE, Aad “Generate new 
token” (生成 令 牌 ) 按钮 。 这 样 一 来 ， 你 就 会 拥有 一 个 由 用 户 名 和 密码 
混合 而 成 的 个 人 访问 令 脾 ， 这 个 令 脾 可 以 用 于 进行 API 身 份 验 证 。 需 要 
注意 的 是 ， 令 牌 只 会 在 生成 时 出 现 一 次 ， 之 后 便 不 再 出 现 ， 因 此 用 户 
需要 把 这 个 令 牌 存储 到 安全 的 地 方 。 


eee < L @ Digital Ocea cloud.digitalocean.com/settings/applic 


> 由 - 
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图 10-8 在 Digital Ocean 上 生成 个 人 访问 令 牌 非常 简单 ， 只 需要 点 击 “Generate new token” 即 可 


为 了 使 用 Docker 机 器 在 Digital Ocean 上 创建 Docker 宿 主 ， 我 们 需 
在 控制 台 执 行 以 下 命令 : 


docker-machine create --driver digitalocean --digitalocean-access- 
token <tokenwsd 

Creating CA: /home/sausheong/.docker/machine/certs/ca.pem 
Creating client certificate: 


/home/sausheong/.docker/machine/certs/cert.pem 

Creating SSH key... 

Creating Digital Ocean droplet... 

To see how to connect Docker to this machine, run: docker-machine 
env wsd 


在 成 功 创建 远程 Docker 答 主 之 后 ， 接 下 来 要 做 的 就 是 与 之 进行 连 
接 。 注 意 ， 因 为 我 们 的 Docker 客 户 端 目前 还 连接 着 本 地 Docker 镶 主 ， 所 
以 我 们 需要 对 它 进行 调整 ， 让 它 改 为 连接 Digital Pa 
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说 ， 我 们 需要 执行 以 下 命令 : 


docker-machine env wsd 

export DOCKER_TLS_VERIFY="1" 

export DOCKER_HOST="tcp://104.236.0.57:2376" 
export 


DOCKER_CERT_PATH="/home/sausheong/ .docker/machine/machines/wsd" 
export DOCKER_MACHINE_NAME="wsd" 

# Run this command to configure your shell: 

# eval "$(docker-machine env wsd)" 


这 条 命令 展示 了 云 上 的 Docker 答 主 的 环境 设置 ， 而 我 们 要 做 的 就 
是 修改 现 有 的 环境 设置 ， 让 客户 端 指 癌 这 个 Docker 答 主 而 不 是 本 地 
Docker 和 宿主 ， 这 一 点 可 以 通过 执行 以 下 命令 来 完成 : 


eval "$(docker-machine env wsd)" 


Po 


这 条 人 简单 的 命令 会 让 Docker 容 户 端 连 接 到 Digital Ocean YDockerfei 
主 之 上 。 为 了 确认 这 一 点 ， 我 们 可 以 执行 以 下 命令 : 


docker images 


如 有 条 一 切 正 前 ， 应 该 不 会 看 见 任何 镜像 。 回 想 一 下 ， 之 前 我 们 在 
连接 本 地 Docker 答 主 的 时 候 ， 曾 经 在 本 地 创建 过 一 个 镜像 ， 如 果 客 户 
端 还 在 连接 本 地 往 主 ， 那 么 至 少 会 看 到 之 前 创建 的 镜像 ， 而 没有 看 见 
任何 镜像 则 表示 客户 问 已 经 没有 再 连接 到 本 地 Docker 答 主 了 。 


因为 狐 的 Docker 答 主 还 没有 任何 镜像 可 用 ， 所 以 我 们 授 下 来 要 做 
的 就 是 在 新 御 主 上 重新 创建 镜像 ， 为 此 ， 我 们 需要 再 次 执行 之 前 提 到 


过 的 docker build 命令 : 


docker build -t ws-d . 


在 这 条 命令 执行 完毕 之 后 ， 用 户 使 用 docker images 至 少 会 看 
到 两 个 镜像 ， 其 中 一 个 是 golang 基础 镜像 ， 而 男 一 个 则 是 新 创建 的 
ws-d 镜像 。 现 在 ,一切 部 已 束 绪 ， 我 们 最 后 要 做 的 就 古 跟 之 前 一 样 ， 
通过 镜像 运行 容 右 : 


docker run --publish 80:8080 --name simple web_service --rm ws-d 


这 条 命令 将 在 远程 Docker 宿 主 上 面 创 建 并 启动 一 个 容器 。 为 了 验 
证 这 一 点 ， 我 们 可 以 跟 之 前 一 样 ， 通 过 cur1 创建 并 获取 一 条 数据 库 记 
录 。 跟 之 前 不 一 样 的 是 ， 这 次 curl 将 不 再 是 向 本 地 服务 器 发 送 POST 
请 求 ， 而 是 向 远程 服务 器 发 送 POST 请 求 ， 而 这 个 远程 服务 器 的 了 P 地 
址 就 是 docker -machine env wsd 命令 返回 的 IP 地 址 : 


curl -i -X GET http://104.236.0.57/post/1 
HTTP/1.1 200 OK 

Content-Type: application/json 

Date: Mon, 03 Aug 2015 11:35:46 GMT 
Content-Length: 69 


"iq" . 2 

x E 
"content": "My first post", 
"author": "Sau Sheong" 


} 


KIER! 以 上 就 是 通过 Docker 容 絮 将 一 个 简单 的 Go Web 服 务 部 
署 到 互联 网 所 需 的 全 部 步 又 。Docker 并 不 是 部 署 Go Web 应 用 最 简单 的 
方式 ， 但 这 种 部 署 方 式 正在 变 得 越 来 越 流行 。 与 此 同时 ， 通 过 使 用 
Docker， 用 户 只 需要 在 本 地 成 切 部 署 过 一 次 ， 就 可 以 宫 不 费力 地 在 多 
个 私有 或 者 公有 的 云 供 应 商 上 重复 进行 部 署 ， 而 这 一 点 正 是 Docker 真 
正 的 威力 所 在 。 圣 运 的 是 ， 现 在 你 已 经 知道 该 如 何 通过 Docker 来 获得 
这 三 优势 了 


为 了 保证 本 章 以 及 本 世 的 内 容 足 够 简短 并 且 目 标 足 够 明确 ， 这 里 
SHAN AAI T KEHAT 2 MRA Dockers (这 是 一 件 好 
事 ， 因 为 它 是 一 个 非常 有 趣 的 新 工具 ) ， 那 么 可 以 花 些 时 间 阅 读 
Docker 的 在 线 文档 (https://docs.docker.com/) 以 及 其 他 关于 Docker 的 文 


H ° 


10.5 “部署 方法 之 间 的 对 比 


在 结束 本 章 之 前 ， 让 我 们 通过 表 10-1 来 回顾 一 下 本 章 介 绍 的 几 种 
部 署 方法 ， 不 过 别 志 了， 这 些 方 法 只 是 许 许 多 多 Web 应 用 部 署 方法 中 的 
儿 种 而 已 。 


3210-1 几 种 Go Web 应 用 部 署 方法 的 对 比 


公有 或 私有 


10.6 ”小结 


。 部 署 Go Web 服 


到 服务 器 里 面 (这 


Heroku 是 一 个 公有 


PaaS 平 台 ， 


数 几 项 限制 之 外 ， | 平台 ， 


事情 


更 用 者 几乎 可 以 做 | 需 


GAE 是 一 个 严 


除了 少 | 格 受 限 的 PaaS 


使 用 者 


Docker 是 一 项 非常 有 前 
景 的 技术 ， 无 论 是 公有 
的 部 署 还 是 私有 的 部 


RET 人 
SPEER 


， 都 有 很 多 供应 商 可 


切 绑 定 


务 最 简单 的 方法 就 古 直 接 将 二 
个 服务 


供 选 择 


进 制 可 执行 文件 放置 


稻 可 以 是 虚拟 机 ， 也 可 以 是 实际 存在 的 


服务 器 ) ， 然 后 通过 配置 Upstart 来 保证 服务 可 以 随 系统 启 动 并 持 
续 地 运行 下 去 。 

Heroku 是 最 简单 易 用 的 Paas 平 台 之 一 ， 将 Go web 服务 部 署 到 
Heroku 平 台 的 方法 非常 简单 直接 ， 只 需要 对 代码 做 一 些微 小 的 修 
改 ， 然 后 使 用 Godep 生 成 本 地 依赖 关系 并 创建 Procfile 文 件 即 可 。 最 
后 ， 用 户 只 需要 将 Web 应 用 的 全 部 代码 推送 到 Heroku 的 Git 代 码 库 
就 可 以 完成 部 署 工 作 。 

GAE 是 Google 公 司 提供 的 一 个 非常 强大 的 沙 箱 PaaS 平 台 ， 这 个 平 
台 的 缺点 是 部 署 方法 比较 复杂 ， 但 它 的 优点 在 于 被 部 署 的 Web 服 务 
将 获得 非常 好 的 可 扩展 性 。 

Docker 是 一 种 最 近 开 始 轿 露头 角 并 且 威 力 强大 的 Web 服 务 和 Web 信 
用 部 署 方式 。 跟 其 他 部 署 方式 相 比 ，Docker 部 署 方式 要 复杂 得 

多 。 用 户 首先 需要 将 被 部 署 的 Go Web 服 务 Docker 化 为 容器 ， 然 后 
才能 在 本 地 Docker 答 主 或 者 云端 的 远程 Docker 答 主 上 部 署 这 个 容 


a 


器 。 


附录 ”安装 和 设置 Go 


安装 Go 


在 编写 Go 代码 之 前 ， 我 们 需要 先 设 置 好 相关 的 环境 。 首 先 要 做 的 
就 是 安装 Go 语言 ， 这 一 工作 可 以 通过 下 载 并 安装 官方 提供 的 二 进 制 发 
行 版 来 完成 ， 在 需要 的 情况 下 ， 我 们 也 可 以 通过 源 代码 来 安装 Go。 在 
撰写 本 书 的 时 候 ，Go 的 最 新 版 本 为 1.6。 


Go 官方 为 release 8 或 以 上 版 本 的 FreeBSD、2.6.23 或 以 上 版 本 的 
Linux、SnowLeopard 或 以 上 版 本 的 Mac OS X、XP 或 以 上 版 本 的 
Windows 都 提供 了 文 持 32 位 (386) 和 64 位 (amd64) x86 处 理 器 架构 的 
二 进 制 发 行 版 。 除 此 之 外 ，Go 还 为 FreeBSD 和 Linux 提 供 了 支持 ARM 
处 理 屁 架构 的 二 进 制 发 行 版 。 


以 上 提 到 的 所 有 发 行 版 的 安装 包 都 可 以 在 https:Wgolang.org/dly 下 
载 。 读 者 可 根据 所 使 用 的 平台 选择 并 下 载 相应 的 安装 包 ， 然 后 按照 本 
文 接 下 来 介绍 的 方法 进行 安装 。 需 要 注意 的 是 ， 尽 管 Go 语言 本 吴 并 不 
依赖 任何 源 代码 版 本 控制 系统 ， 但 是 诸如 go get 等 工具 却 需 要 用 到 
源 代码 版 本 控制 系统 ， 因 此 为 了 能 够 更 方便 地 使 用 Go 语言 进行 开发 ， 
我 们 建议 在 安装 Go 的 同时 也 安装 相应 的 源 代 码 版 本 控制 系统 。 


关于 源 代 码 版 本 控制 系统 的 下 载 和 安装 方法 可 以 在 以 下 这 些 网 站 
ee 


e Mercurial 


http://mercurial.selenic.com; 
e Subversion 


e Git 


http://subversion.apache.org ; 


http://git-scm.com; 


e Bazaar 


http://bazaar.canonical.com ° 
Linux 和 FreeBSD 


要 在 Linux 或 FreeBSD 上 安装 Go， 首 先 需 要 下 载 go< 版 本 > .< 操作 
系统 >-< 架 构 >, tar.gz 文件 。 比 如 ， 当 前 64 位 架构 的 Linux 安 装 包 的 
名 字 就 为 go1.6.3.1linux-amd64.tar.gz。 


压缩 包 下 载 好 了 之 后 ， 将 它 解压 到 /usr/local 目录 中 ， 并 将 目 
a 添加 到 PATH 环境 变量 当中 。 添 加 环境 变量 
的 工作 可 以 通过 将 以 下 代码 行 添加 a 到 /etc/profile 文件 或 
$HOME/ . profile 文件 中 来 完成 : 


export PATH=$PATH:/usr/local/go/bin 


Windows 


使 用 Windows 操 作 系 统 的 读者 可 以 通过 下 载 MSI 安 装 包 或 者 zip 压 
缩 包 来 安装 Go。 使 用 MSI 安 闭 包 进行 安装 相对 来 说 更 容易 一 些 ， 只 需 
要 运行 MSI 安 装 包 然 后 按照 指示 进行 安装 就 可 以 了 。 在 默认 情况 下 ， 
安装 包 会 将 Go 安装 到 c:\Go 文件 夹 里 面 ， 并 将 c:\Go\bin WRA 
加 到 PATH 环境 变量 中 。 


使 用 zip 压 缩 包 进行 安装 也 是 非常 容易 的 ， 只 需要 将 压缩 包 解 压 到 
一 个 文件 夹 里 面 (如 c:\Go) ， 然 后 将 这 个 文件 夹 中 的 bin 子 文件 夹 
添加 到 PATH 环境 变量 中 就 可 以 了 。 


Mac OS X 


(EH Mac OS X 操 作 系 统 的 读者 可 以 通过 下 载 相应 的 PKG 安 装 包 来 
安装 Go。 安 装 包 会 将 相应 的 Go 发 行 版 安装 到 /usr/1LocaVgo 目录 里 
面 ， 并 将 目录 /usr/1local/go/bin 添加 到 PATH 环境 变量 中 。 在 安 
装 完成 之 后 ， 需 要 重启 终端 ， 或 者 在 终端 里 面 执行 以 下 命令 : 


$ source ~/.profile 


除 使 用 PKG 安 装 包 进行 安装 之 外 ， 我 们 还 可 以 通过 执行 以 下 命令 
来 使 用 Homebrew 安 装 Go: 


$ brew install go 


设置 Go 


在 安 狠 Go 之 后 ， 我 们 还 需要 对 它 做 一 些 设置 。Go 语 言 的 开发 工具 
能 够 基于 公开 托管 的 代码 项 目 进 行 协 作 ， 它 们 既 适 用 于 开源 项 目 ， 也 
适用 于 其 他 项 目 。 


Go 代码 一 般 都 是 在 工作 空间 (workspace) 中 进行 开发 的 ， 工 作 
空间 指 的 是 包含 以 下 3 个 子 日 好 的 目录 : 


。 src 目录 ， 用 于 包含 Go 源 代码 文件 ， 这 些 源 代码 文件 会 被 组 织 成 
一 个 个 包 (package) ， src 目录 中 的 每 个 子 目录 都 表示 一 个 
Al; 

。 pkg 目录 ， 用 于 包含 包 对 象 (package object) ; 

© bin 目录 ， 用 于 包含 可 执行 的 二 进 制 文件 。 


图 A-1 展 示 了 一 个 工作 空间 的 例子 。 


工作 空间 的 工作 方式 非常 简单 。 当 编译 Go 代码 的 时 候 ， 编 译 器 会 
创建 相应 的 包 E) 以 及 二 进 制 可 执行 文件 ， 并 将 这 些 包 和 可 执行 文 
件 放 到 相应 的 目录 中 。 如 图 A-1 所 示 ， 我 们 在 src 目录 中 创建 了 一 个 
first webapp 目录 ， 并 在 这 个 目录 里 面 放置 了 一 个 webapp .go 文 
件 ， 以 此 来 构建 一 个 简单 的 Web 应 用 。 当 我 们 编译 这 个 Web 应 用 的 源 
代码 时 ， 编 译 器 会 将 生成 的 二 进 制 可 执行 文件 放置 到 这 个 工作 空间 的 
bin 目录 里 面 。 


eee E gows 
< A = iol RY ORY Q 


Name a Size Kind 


v E bin -- Folder 
EH first_webapp 5.7MB Unix E...le File 
v BS pkg -- Folder 
v D darwin_386 -- Folder 
> D code.google.com -- Folder 
> B github.com -- Folder 
> FI darwin_amd64 -- Folder 
v src -- Folder 
v HM first_webapp —— Folder 
\@| webapp.go 241 bytes § TextM...cument 


10 items, 241.5 GB available 


图 A-1 Go 工作 空间 的 目录 结构 


设置 工作 空间 的 任务 可 以 通过 设置 GOPATH 环境 变量 来 完成 。 你 
可 以 使 用 除 Go 安 装 位 置 之 外 的 其 他 任何 目录 来 作为 目 己 的 工作 空间 。 
举 个 例子 ， 假 如 你 想 要 将 Linux、FreeBSD 或 者 Mac OS X FAY 
$HOME/go 目录 设置 为 工作 空间 ， 那 么 你 只 需要 在 终端 中 执行 以 下 命 
令 即 可 : 


$ mkdir $HOME/go 


$ export GOPATH=$HOME/go 


你 也 可 以 通过 将 以 下 代码 行 添 加 到 自己 的 ~/ ,profile 文件 或 者 
~/ bashrc 文件 里 面 来 让 设置 一 直 有 效 : 


export GOPATH=$HOME/go 


PO 


为 了 方便 ， 我 们 可 以 在 设置 工作 空间 的 同时 ， 通 过 执行 以 下 命令 
来 将 工作 空间 中 的 bin 目 孙 添加 到 PATH 环境 变量 当中 : 


$ export PATH=$PATH: $GOPATH/bin 


ER, BUSCA) LA BT Sa as Got T° 


欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 社 旗下 IT 专业 图 书 旗 
舰 社 区 ， 于 2015 年 8 月 上 线 运营 。 


异步 社区 依托 于 人 民 邮 电 出 版 社 20 余 年 的 IT 专业 优质 出 版 资源 和 
编辑 策划 团队 ， 打 造 传 统 出 版 与 电子 出 版 和 上 自 出 版 结合 、 纸 质 书 与 电 
子 书 结合 、 传 统 印 刷 与 POD 按 需 印 刷 结合 的 出 版 平台 ， 提 供 最 新 技术 
资讯 ， 为 作者 和 读者 打造 交流 互动 的 平台 。 
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即日 起 到 | A +4 r - 
1 月 26 号 Pings J 8 AE: 


Free eBook 
= Write for Us 
Python 机 局 学 习 一 一 预 TRAE: BÆRE 。 ”机 器 学 习 项 目 开 发 安 战 DHS: 统计 建 模 
测 分 析 校 心算 法 SNHR 的 Python 学习 法 近期 活动 


社区 里 都 有 什么 ? 
购买 图 书 


我 们 出 版 的 图 书 涵盖 主流 芽 技术 ， 在 编程 语言 、 Web 技 术 、 数 据 科 
学 等 领域 有 众多 经 典 畅 销 图 书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 
400 多 种 ， 部 分 新 书 实现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 会 定期 发 布 新 
书 书 讯 。 


下 载 资源 


社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 程序 源 代码 。 


男 外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 注册 成 为 社区 用 户 
束 可 以 免费 下 载 。 


与 作 译 者 互动 


很 多 图 书 的 作 译 者 已 经 入 驻 社区 ， 您 可 以 关注 他 们 ， 咨 询 技术 问 
题 ; 可 以 阅读 不 断 更 新 的 技术 文章 ， 听 作 译 者 和 编辑 畅 聊 好 书 背 后 有 
趣 的 故事 ;还 可 以 参与 社区 的 作者 访谈 栏目 ， 回 您 天 广 的 作者 提出 采 
访 题目 。 


灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 纸 质 图 书 直接 从 人 
民 邮 电 出 版 社 书库 发 货 ， 电 子 书 提供 多 种 阅读 格式 。 


对 于 重 磅 新 书 ， 社 区 提供 预 售 和 新 书 首发 服务 ， 用 户 可 以 第 一 时 
间 买 到 心仪 的 新 书 。 


用 户 帐户 中 的 积分 可 以 用 于 购书 优惠 。100 积 分 =1 元 ， 购 买 图 书 
时 ,在 : kam 里 项 入 可 使 用 的 积分 数值 ， 即 可 扣 减 相应 金额 。 


| NIEA OA IIO E A EOE N N AOE AA OAE O ETE | 


购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 使 用 方法 ， 注 册 成 为 社区 用 户 ， 在 下 单 购 
书 时 输入 "57AWG ”， 然 后 点 击 “ 使 用 优惠 码 ”， 即 可 享受 电子 书 8 折 优惠 (本 优惠 券 只 可 使 用 
一 次 ) 。 | 


纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购买 方式 ， 价 格 优惠 ， 一 次 
购买 ， 多 种 阅读 选择 。 
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社区 里 还 可 以 做 什么 ? 


提交 勘误 


您 可 以 在 图 书页 面 下 方 提 区 勘误 ， 每 条 勘误 被 确认 后 可 以 获得 100 
积分 。 热 心 勤 误 的 读者 还 有 机 会 参与 书稿 的 审 校 和 翻译 工作 。 


写作 


性 区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写 作 的 您 可 以 在 此 一 试 
身手 ， 在 社区 里 分 享 您 的 技术 心得 和 读书 体会 ， 更 可 以 体验 目 出 版 的 
乐趣 ， 轻 松 实现 出 版 的 梦想 。 


如 有 果 成 为 社区 认证 作 译 者 ， 还 可 以 享受 异步 社区 提供 的 作者 专 享 
特色 服务 。 


会 议 活 动 早 知道 
您 可 以 掌握 代 圈 的 技术 会 议 资 讯 ， 更 有 机 会 免费 获 赠 大 会 门票 。 


加 入 异步 


扫描 任意 二 维 码 都 能 找到 我 们 : 


微 信服 务 号 


QQ 群 : 436746675 


社区 网 址 : www.epubit.com.cn 


BAR: 异步 社区 


官方 微 博 : @ 人 邮 异 步 社 区 ，@ 人 民 邮 电 出 版 社 -信息 技术 分 社 


投稿 & 咨 询 : contact@epubit.com.cn 


